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WELCOME 
to The MagP1 141 


rtificial Intelligence remains the hottest topic in 
A technology. Especially generative АТ, a new piece of 
tech that promises to do all the creative work for us 
while we sit on the beach. Hurrah! 
Of course, it’s never that simple. There are ethical 


conversations surrounding generative AI, something that Нан, 

- as a technology - is both complicated and opaque. Lucy is still the 
Who knows what is going on inside? KG does, that's who. ТИ 

Our Raspberry Рі AI Made Clear feature (page 30) demystifies B dan ү 


artificial intelligence by showing you how to develop 
generative technologies using Raspberry Pi and open-source 
software. Create personal image diffusers, generate large 
language models, and assemble intelligent-acting robots, 
cameras, and speech assistants. All while keeping one eye 
on the ethics at play! 

With The MagPi magazine you will understand AI without 
resorting to ChatGPT to hallucinate an answer. You'll learn 
how AI works! No small skill 
to have for the years ahead. T 
Enjoy this issue! | 
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Home projects made easy. 


CDP Studio, a great software development tool for your home projects. Build 
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P1DP-10 


After tackling the PDP-8 and PDPTI, 
Oscar Vermeulen goes mainframe with 
DEC's PDP-10, PJ Evans fires up the big iron 


digital 


Oscar 
Vermeulen 


Oscar, 56, lives in 
Switzerland and 
likes to spend his 
time dabbling as a 
Maker. He has been 
collecting vintage 
computers for the last 
30 years, going back 
further and further 
in computer history. 


obsolescence.dev 
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Oscar Vermeulen has wowed us with his 

faithful scale models of Digital Equipment 
Corporation (DEC) hardware. First came the 
PiDP-8, which paired a Raspberry Pi-based emulator 
with a meticulously recreated front panel to recreate 
the ‘blinkenlights’ experience. A few years later a 
more ambitious PiDP-11 project introduced a custom 
injection - moulded case for the PDP-8’s big brother. 
Now, Oscar has completed his most ambitious 
project yet, a two-thirds replica of the PDP-10. 

Before we get to the project itself, we wondered 
why the PDP range had been recreated in this 
order. In other words, why make the PDP-10 now? 
“The first PiDP was a replica of the PDP-8. From 
1968, at the time it was the absolute minimum 
hardware that could be a useful computer. DEC, 
the manufacturer, actually saw it as we'd now 
see an Arduino,” explains Oscar. “Then, I did the 
PDP-11 next. It's the forefather of ‘everything’ we 
have today. Unix grew up on the PDP-11, so that 
gets you Linux, Android and macOS today.” So 
while the PDP-8 and PDP-11 shared a ‘smaller’ 
computing architecture, the PDP-10 was a different 
beast altogether, a mainframe. 

Mainframes were actually quite boring machines 
to work with. You created punch-cards, fed them 
in, waited, then a response was printed out. DEC’s 
PDP-10 was the first to be truly interactive. It was 
DEC’s decision in 1968 to provide a unit to MIT 
that really sealed its place in history. For the first 
time, a mainframe became a multi-use computer. 
Students and staff attached graphics terminals and 
other displays and started hacking the system. One 


Q ver the years, maker and retro enthusiast 


of the main outcomes from this period was the first 
computer game, Spacewar! PDP-10s were the first 
computers to connect via ARPANET, which later 
became the internet. 


Pieces of the puzzle 

Oscar’s new project had two distinct parts: The 
emulator and the hardware. In truth, the hardware 
is a simple lightboard with some control circuitry. 
It's the attention to detail that makes it special. 
However the software was a bigger problem. Oscar 
wanted to recreate the MIT experience, and that 
meant emulating their custom operating system, 
the Incompatible Timesharing System (ITS). 
Fortunately, a group was already working hard 
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The first ever computer 
games ran on the PDP-10, 
and you can play them too 


Early computers allowed 
an operator to view their 


workings, which became 


known as 'blinkenlights' 


The operator can use a 
terminal, teleprinter or the key 


panel to control the computer 


Oscar is now 
ramping up 
production of kits 


Can also be 
used as a regular 
Raspberry Pi too 


Allows you to 
experience a 
crucial part of early 
computer history 


Two or more 
can recreate the 
original ARPANET 


Play Spacewar!, the 
first computer game 


on emulating ITS, despite MIT having switched 
everything off in the 1990s. When Oscar met Lars 
Brinkhoff, the principal driver of the project, the 
PiDP-10 was born. 
Now emulation was taken care of, attention 
turned to the hardware. Part of the magic of the 
PDP-10 is its beautiful panel, complete with rows of 
lights and toggle switches. Oscar was determined to 
create an accurate replica and found it a satisfying 
and fun process: "Producing that pretty front panel, 
with its artwork and transparent windows for the 
LEDs behind it. That is artisanal work that I really 
enjoy. Endless tinkering, and then tweaking a big 
printer to print out the front panels with the exactly : 
correct colours, that sort of thing. е components that make up the PDP-10 are simple, but precision built 
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The injected- moulded case, over 50 cm in width, 
would be more challenging though. "The problem 
with injection mould making is - you make a 3D 
model, you give it to a mould maker, and if you're 
lucky he makes a mould to your specifications. 
Any mistake you made in your 3D model is your 
problem, there is no going back to fix things." 
Luckily, Oscar found a friendly manufacturer who 
understood the importance of the project and 
helped him with the process. The result took two 
years to get right. 

The PCB was designed in Kicad, connecting 
matrices of LEDs and switches to the GPIO of a 
Raspberry Pi 5, which would be hidden away inside 
the case. The next challenge was to interface 
everything together. “Part of the fun is getting 
the simulator working right. Making sure that it 
blinks the right LEDs at the right time, that the 
complex front panel switches for the debugger 
built into the system really work as they did on 


the old machine." explained Oscar. But how to 
confirm this? Since the mid-eighties there have 
been no operational PDP-10s. In 2018 Paul Allen, 
co-founder of Microsoft, who had a strong affinity 
with the mainframe, tasked the Living Computer 
Museum in Seattle with restoring an example. 
Shortly before the pandemic, Oscar was able to see 
the machine working and fine-tune the emulation 
to match. Sadly Allen died a few weeks before the 
restoration was complete. 

It was obvious to Oscar that the recreated PDP- 
10 would be based on Raspberry Pi. A primary 
factor was cost, as he could see no way he could 
assemble all the I/O ports and connectors necessary 
for less than the cost of Raspberry Pi 5, which had 
everything he needed. Even though the Raspberry 
Pi does not run a true real-time operating system, 
it is fast enough to be able to scan the switches 
and refresh the LEDs two hundred times a second, 
which is more than enough for accurate emulation. 


m Part of the fun is getting the simulator 
working right. Making sure that it blinks the 


right LEDs at the right time Ø 


went О — 


we ттен 


P A look at the back 
reveals the mount for 
Raspberry Pi 5 
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Two hearts 

Oscar also wanted the result to be ‘dual-hearted’. 
Emulating a PDP-10 and controlling the front panel 
is a breeze for Raspberry Pi 5, so there's plenty of 
processing power available to run other things such 
as a media server. It's certainly more aesthetically 
pleasing than a small black box. 

Is Oscar happy with the result? *Yes! In the end, 
I think the primary motivator for such a project 
is that you want to have this thing for yourself, 
blinking away in your living room, and it becomes 
almost an obsession to Get It Right. And I think 
we did." He acknowledges that this has been 
a project with a lot of contributors such as the 
ITS Reconstruction Project and many ex-Digital 
employees, many of which attended the project's 
launch at MIT in April. 

Best of all, if you're happy with through-hole 
soldering, you can have your own PiDP-10! Oscar 
has put the kit into production and you can order 
it from his site (magpi.cc/pidp10) and build your 
very own 1960s mainframe. This project has taken 
seven years, but Oscar is not done yet. Next on 
the list is the PDP-1 from the 1950s which would 
complete the ‘evolutionary tree’ of interactive 
computers. We can’t wait. Ш 


У The beautiful injection- 
moulded case is two-thirds 
Scale and took two years 
to get right 
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Build your own PDP-10 


The PCB is a simple design, but there are a 
lot of components. Getting LEDs to line up 
perfectly is challenging, so Oscar has included an 
extra board that holds them all when soldering. 


Once the lights and the switches are soldered, 
it's time to connect them up with a small 
ribbon cable. This is a good time to test everything 
before mounting the PCBs. 


In this step we see the keys mounted into the 
injection-moulded case. Now the light board 
will be mounted and Raspberry Pi 5 can be installed 
using a further backplate. 
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Keen to delight family members, maker 
Rolf Jethon used Raspberry Pi to animate 
a puppet. Rosie Hattersley listens in 


12 


3 Rolf 


Jethon 


| RolfJethon enjoys 
using hardware and 
software to overcome 
problems as well as 
perfecting his clever 
ventriloquist designs 


| magpicc | 


Bechele 3.0 


| The rollers from deodorant sticks 
double as Mr Bechele's moving eyes 


uppets and play are always popular at 

С children's parties, and the concept struck 
E maker Rolf Jethon as an equally fun 
diversion for his father’s birthday celebration. 
The hand puppet he made for the occasion 
was a hit, but Rolf found himself tongue-tied, 
somewhat muting his own experience: “Though 
I thought I was prepared well, I forgot part of the 
text, couldn’t master the ventriloquism and the 
performance stuck several times.” As a technical 
engineer of many years, Rolf decided to use 
Raspberry Pi to add motion and speech to the 
existing doll, named Mr Bechele, and have it make 
another appearance, this time at his mother’s 80th 
birthday party. Although he still had performance 
issues, things went better once Rolf mechanised 
some of the actions. Over the subsequent years, 
he has refined both Bechele’s 3D-printed design 
and the software used to animate him and has just 
launched Bechele 3.0. 


A well-rehearsed speech 

A precision mechanics degree followed by a 
technical career meant Rolf soon encountered 
and embraced Unix, and latterly Raspberry Pi, 
both of which came in useful in his free time in 
which he enjoyed both hardware and software 
design challenges. “I felt familiar with Raspberry 
Pi from the beginning: it came with all the well- 
known tools of Linux, but also provided a cheap, 
space- and resource- demand reduced way of 
realising projects.” 


A USB joystick or 
gamepad can be 
used to control 
the puppet 


Rolf dislikes their 
imprecision, 
however, and uses 


Rolf designed and 3D printed a serial port version 


the base, eye sockets and strips 

that hold the servos that animate He kept costs 

the ventriloquist's puppet low by using 
cheap, but less 
reliable, servos.. 


He wrote code 

that made 
Raspberry Pi (the first version replacing them 
used Raspberry Pi 1B) fits neatly straightforward 
in Bechele's base, controlling the 
actions and Al-based response script 


Rolf spent many 
hours calibrating 
the motors 


Rolf's Bechele puppets 
and their 3D-printed 
ventriloquist heads 
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+ Animating this 24 servo model took roughly two hours 


Rolf particularly likes using Raspberry Pi headless 
and getting it to run things as a 'sophisticated 
worker! in the background. Using a Raspberry 
Pi-based setup to turn his hand puppet into a 
ventriloquist's dummy seemed a natural extension 
of this idea. The audio outputs, GPIO connections 
and the conveniently compact size that meant 
Raspberry Pi could fit inside the puppet's head 
were all compelling. "The idea was to build 

a puppet that talks to me and does the face 
movement on its own. The whole thing should 
work mainly fully automated [with the] eye, mouth 
and face movements recorded before, and following 
a prepared conversation. My task was finally just to 
ask the puppet the right questions." 


m The audio outputs, GPIO 
connections and the 
conveniently compact 
size were all compelling Ø 


A Raspberry Pi audio and serial joystick connections 
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Resourceful approach 

Rolf designed and made any hardware for the 
Bechele puppets that he couldn't readily source. 
The eyes are balls from roll-on deodorant 
sticks with eyelids and sockets, and the control 
mechanisms are designed in Rhino CAD and 
then 3D printed. These can be downloaded from 
Thingiverse (magpi.cc/eyething). 

However, it was servos that gave Rolf the biggest 
headache: Bechele uses 24 SG90 servos, so there 
were challenges to controlling them all, which Rolf 
partially solved by using PCA9685 PWM circuit 
boards he'd used successfully in Arduino projects. 
Resource overheads meant it was very slow driving 
these using the existing Perl script and the Raspberry 
Pi i2C connection, but Rolf overcame this by writing 
his own Perl driver. His code meant the Raspberry Pi 
could theoretically control up to 64 servos at once. 
Getting the most from his chosen hardware 
involved careful and time-consuming calibration 
of the joystick and recording the movement 
parameters for each of the servos, but having 
optimised them, Rolf was then able to swap out 
any servos as needed easily. He explains that the 
Bechele software “15 fully written in Perl and 
can be used headless. It loads quickly and has a 
graphical interface for the teaching process". The 
number of devices and interfaces involved make 
installation a challenge, Rolf warns, but he's 
created a SD card image that anyone can download 
from magpi.cc/bechele. [i 


+ The heads are fitted with 
servos and other parts 
ready for assembly 
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Feeling animated 


The Bechele blog (magpi.cc/becheleblog) 
explains how to 3D print, assemble and install 
code to animate a doll or puppet, as well as how to 

learn the process yourself. 


Seven servos are used to animate the 
eyes. Rolf suggests this version (magpi.cc/ 
eyemechanics) is simpler to replicate than the one 
in his main setup demonstration video. The 
background audio files are used under a Creative 
Commons licence. 


Raspberry Pi fits in the base and connects to 
the 16- or 24-servo configuration via GPIO. Rolf 
provides downloadable Bechele 3.0 software for 
models up to Raspberry Pi 4B. 
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Retro-Printer 


Got an old computer or piece of equipment but want to 
print out graphics and text? David Crookes looks at a 
device that connects retro machines to modern printers 


Rich 
Mellor 


Rich Mellor, a 
former solicitor 
from Walsall, is 
completely self- 
taught in computer 
programming 
having learned 

on the Sinclair 
ZX81 and QL. 


retroprinter.com 
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any people hate printers and that's 
M putting it mildly. With every paper jam, 

every automatic update and every message 
that a single ink colour has run out forcing you to 
replace the lot, comes much gnashing of teeth and 
an uncontrollable urge to throw the contraption 
out of the window. It's why there are rage rooms 
inside which you can smash the things up with 
sledgehammers. And yet printers are still useful 
and that makes them even more annoying. 

Acknowledging the printer's worth - grudgingly, 
we'd suspect - is Rich Mellor, who has had hands- 
on experience with so many of them over the years, 
from the humble clackity-clack dot matrix varieties 
to the slick inkjets and professional lasers. To his 
frustration, he's noted two things in that time: the 
expense of buying modern equivalents of old-tech 
printers, and the lack of compatibility between 
newer printers and retro computers. 

“I was working at Heathrow Airport developing 
controls software for a baggage handling line in 
1999 when we decided it would be useful to attach 
a dot matrix printer to keep track of errors and 
how the code was treating each piece of luggage 
passing through the system," he explains. 

“The choices for a dot matrix printer with a 
Centronics connector were very limited and still 
cost more than £500. From using a Sinclair QL 


The Retro-Printer understands both text 
and graphics created on a wide range of 
retro computers including this one - an 
Amstrad CPC 6128 running Protext 


at home I also knew the problems of finding a 
suitable printer which understood plain text and 
realised this was going to pose an increasing issue 
for home-computer users and industry." 

Having talked with two fellow electrical 
engineers, he tried in vain to work out a low- 
cost solution. “It was only with the release of the 
earliest Raspberry Pi that I realised an affordable 
printer emulator could be developed," he says. This 
prompted him to begin work on the Retro- Printer 
project - a HAT designed to plug into a Raspberry 
Pi computer that allows data captured from the 


The Retro-Printer HAT 
means you don't need 
to buy an expensive 
dot-matrix printer, delve 
into the used market 
(and struggle to find ink 
cartridges or ribbons) or 
upgrade your software 
and equipment 


A Centronics cable is needed to connect 
aretro computer to the Retro-Printer. Rich 
found it difficult to get a big supply of 
female Centronics connectors 


с 
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The Retro-Printer converts data so it 

can be stored electronically or sent toa 
USB or network printer (you can connect 
wirelessly or via USB) 


It connects to the 
Centronics port of 
retro computers 


It allows data 

to be sent to 
modern USB and 
network printers 


A large number of 
Centronics printers 
are supported 


The idea originated 
25 years ago! 


Around 500 
Retro-Printers 
have been sold 
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Centronics (or parallel) port on a retro machine to 
be sent to a modern printer. 


Bit by bit 
Most personal computers released from the 1970s 
to the 2000s had Centronics ports for connecting 
the machines to printers and other devices. Data 
would be sent eight bits at a time in parallel to 
each other at 150 kilobytes/sec. Rich figured he 
could develop working hardware that acted as an 
interface between the port of any one of those 
computers and the Raspberry Pi. Software would 
then convert the captured data into a PDF, ready 
for printing. 

“The Retro-Printer HAT is simply an interface 
to convert the incoming data signals from 
the Centronics output to the GPIO pins on a 
Raspberry Pi computer," Rich says. "The hardware 
incorporates some hard-wired signals so that 
the busy signal is asserted as soon as any data is 
received from the Centronics port, and we found 
that we needed to add jumpers to allow 5v to be 
enabled on three different pins of the Centronics 
port as this was expected by some computers. We 
also initially added an offline switch as a nod to the 
fact that many old printers had one but we've since 
changed the software to support different functions 
on that switch such as swapping page sizes or 
printer types." 

The software is written in C and it makes use 
of a single capture process that runs constantly. 

“Tt watches for incoming data, spooling it to 

a temporary file and sending the acknowledge 
and ready signals as we process each byte," Rich 
continues. "That process also has to deal with 

7 - bit or 8-bit data, the position of an offline 
switch and different timing mechanisms." 

There are two background processes: “Опе 
handles the three LEDs on the HAT which can be 
controlled externally by the user if they wish and 
the other is the all-important printer emulator.” 
Since there have been so many different printer 


А The Retro-Printer 
software formed 
Rich's second ever C 
program. His first was 
amending third-party 
code for the Sinclair 
QL to support 720dpi 
and full colour 
printing on an Epson 
printer in 1999 


P Emulating the Seiko 
QT-2100P printer 
was tricky. It works 
with a watch-timer 
instrument, but the 
control codes didn't 
follow any logical 
pattern for text or 
graphics output. Rich 
discovered it sends 
the raw data of tick- 
tock readings froma 
watch and the printer 
decides how to 
display the readings 
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types over the years, testing has been a major 
challenge. *We've had to work alongside users to 
identify and address issues particularly around 
equipment which does not fully implement the 
Centronics protocol or where there is little or no 
information about programming." 


Ink-spiring 

Such is the lack of information about some original 
printers, Rich has sometimes had to rely on old 
faded printouts or photos on the internet. “We’ve 
been able to reverse engineer the printouts mainly 
using a Sinclair QL emulator in the first instance 
to understand what the data means,” he says. As 

a result of all of this, different printer emulators 
have been developed for each printer type. 

“They all include standard classes for reading 
the captured bytes from the temporary file and 
graphics routines and creating the PDFs,” Rich 
explains. “The printer emulator is responsible for 
interrupting each captured byte and determining 
whether it is data for processing, text or a printer 
command - for example, an ESCape code sequence. 

“We then create a PNG of the printed page in 
memory using those printer commands to set the 
position on the page and draw any text or graphics. 
Once the capture process indicates that it thinks 
the end of the print job has been reached, or we 
have filled a page of data, the PNG is converted to a 
PDF for printing or storage." 

Given the amount of work involved, it's 
surprising to hear that the project was created 
rather quickly. “Thanks to a contact in Germany 
who had previously developed hardware for 
the Sinclair ZX81, the initial hardware and 
basic Epson printer emulator only took six 
months to develop,” Rich says. “Getting the 
product readyfor manufacture by a well-known 
Raspberry Pi supplier took a further 12 months, 
although thanks to a production issue picked up 
after the initial batch of boards were received and 
sold, it took another six months before we had a 
v4, Retro-Printer.” 

Not that the work is complete. Development is 
still ongoing as Rich meets new challenges and 
old printer technologies. “We have found a niche 
among retro computer users and industry alike, 
with uses from the humble ZX Spectrum and 
Commodore 64 through to various commercial 
flight simulator and industrial production lines, 
he says. “In some cases, we have extended the 
useful life of multi-million pound equipment 
which would have needed complete replacement 
for the sake of a working printer.” Ш 
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Printing pages 


Connecting up: fit the Retro-Printer HAT to 
Raspberry Pi, install the Retro-Printer software, 
connect an Ethernet cable between your router and 
the device, find the Retro-Printer's IP address and set 
up a wireless LAN connection. 


CUPS.org Home Administration С1аѕѕеѕ Help Jobs Printers 
Add Printer 


Add Printer 


Local Printers: CUPS-BRF (Virtual Braille BRF Printer) 
HP Printer (HPLIP) 
HP Fax (HPLIP) 
Discovered Network Printers: o EPSON ХР-900 Series (EPSON XP-900 Series) 
EPSON XP-900 Series (EPSON XP-900 Series) 
EPSON ХР-900 Series (driverless) (EPSON ХР-900 Series) 
Other Network Printers: — Internet Printing Protocol (ipps) 
Internet Printing Protocol (http) 
Internet Printing Protocol (ipp) 
Backend Error Handler 
Internet Printing Protocol (https) 
LPD/LPR Host or Printer 
AppSocket/HP JetDirect 


Add a printer: plug the device into your retro 
computer. Find the Retro-Printer's IP address 
and connect to the CUPS Linux printing engine. Once 
in CUPS, look for and add your printer (loads are 
supported). Set it as the server default. 


Send a job: now the fun begins. Use your retro 
computer to create a document and instruct 
the machine to print it. The data will be captured by 
the Retro-Printer as a PDF and it can either be stored 
on the device or printed out. 


Retro-Printer | magpicc | 19 


ШШЕН Mägi | PROJECT SHOWCASE 


Mt32-pi1 Atari ST 


Reviving an old synthesiser using Raspberry Pi was a labour 
of love for The MagP/'s publisher, he tells Rosie Hattersley 


Brian 
Jepson 


Brian is The MagPi's 


publishing director 
and a volunteer, 
and restorer at 
Rhode Island 
Computer Museum. 


jepSTone.net 


A The mt32-pi board 
with a five-pin cable 


longside his day job as The MagPi and 
yes magazines! publisher, Brian 

Jepson likes to track down and restore 
old computers. As a volunteer at Rhode Island's 
Computer Museum (ricomputermuseum.org), he 
regularly rescues old computers "from 8-bit on 
up”. A favourite is the Atari ST line of 16/32- 
bit computers which launched in 1985, featured 
Motorola’s 68000 CPU range and, “uniquely, 
could be used with electronic synthesisers as 
well as in home computers". Brian's mt32pi 
synth project shows just how well the 40-year- 
old hardware works with a thoroughly modern 
Raspberry Pi. 


Musical inspiration 
Brian used to enjoy playing music (and regrets not 
having kept it up) and was keen to add a vintage 
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synthesiser to his collection. He observes that 

the Atari ST's MIDI ports were notable because 
certain videogames from the era were capable of 
producing high-quality background music with 

a MIDI synthesiser. "There were many music 
sequencers you could use to compose music with a 
MIDI keyboard and play it on a MIDI synthesiser. 


2 Brian's mt32pi synth 
project shows just how 
well the 40-year-old 
hardware works with 
a thoroughly modern 
Raspberry Pi Ø 


However, the Atari ST was unique in that it had 
built-in MIDI ports for connecting to electronic 
musical instruments as well as synthesisers." 
There are also several MIDI-capable keyboards that 
were designed as videogame controllers that, for 
some reason, include the five-pin MIDI DIN cable, 
Brian continues. “For example, the Rock Band 3 
Wireless Keyboard for Nintendo Wii is a relatively 
affordable keyboard that works great with this 
setup! It's unusual to see the five-pin connector 
because a lot of modern MIDI stuff uses USB now." 
For his own needs, Brian "looked into buying 
a used Roland MT32 synthesiser, which was 
roughly contemporary with the Atari ST, but 
decided the versatility of a Raspberry Pi-based 
solution was preferable". For his Atari ST revival, 
Brian used the ClumsyMIDI board with mt32- pi 


Magi 


ҮШҮҮ» 


The ClumsyMIDI board 
provides a MIDI interface, 
digital audio processor 
and an OLED display. 


Several other boards also 
work with mt32-pi: The 19805 Atari ST MIDI synth 


magpi.cc/mt32piwiki worked with both keyboard and 
electronic instruments, making 
it popular for use in games as 
mt32-pi is an open-source : © wellas with touring musicians 
synthesiser emulator that works 


with Raspberry Pi 3, 4 and Zero 
connected to the Atari's MIDI ports 


Atari ST was 
popular with 1980s 
studio engineers.. 


was it could move 
MIDI bits faster than 


Functions Extra Options Fla ; 
anything else 


SWEET SIXTEEN 2.73 - MRBLUE.MID 


вле 4 16 Te Position Event Cha -1- -2- Length/Info eBay YouRock 
21 1 34 Guitar 2 for a 
decent MIDI 


guitar experience 


21 1 1 


[ 28 4 245 ШШШ Ee 1 147 
11ILLLIJLLILLLJ! EI 
B- 


mt32-pi can also 
be used for retro 
gaming: magpi.cc/ 
mt32gameslist 


Brian recommends 


this article on 
i getting started: 
ead —S SS magpi.cc/ 


mt32pistarter 
E 1. PLAY a DROP IH | upa 


Use the Sweet Sixteen demo track and experiment with different 
synthesised instruments 
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Graphics Control Keymaps Audio Volume | MIDI | MT-32 Paths | 


GM device: USB MIDI Interface [ALSA] 
E - 
Mixed AdLib/MIDI mode 
MIDI gain: @ 
FiuldSynth Settings 


Download The MagPi 114 
for a mt32-pi MIDI setup 
guide (magpi.cc/114) 


Warning! 
Hot solder 


Soldering irons get very 
hot, and stay hot for a 
long time after they're 
unplugged. Make sure 
that you put the iron in 

the stand when you're not 
using it and don't touch 
the metal parts - even 
after it's unplugged. 


magpi.cc/soldering 


Brian's PiSCSI emulator 
came in handy for an 
Atari project too 
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software (magpi.cc/mt32piwiki) - an MT-32 
emulator that works with Raspberry Pi 3, 4 and 
Zero. Developer Dale's wiki explains the project 
in detail: it was ready to go and worked well with 
Brian's Raspberry Pi 3Bs and “а couple of Ataris 
I've outfitted with mt32-pi synthesisers". 


Fast and affordable 

Dale Whinham's open source mt32-pi software 
(magpi.cc/mt32pigit) is a bare-metal MIDI 
synthesiser that operates as a kernel. It boots 
directly into the mt32-pi software, starts up in 
seconds, doesn't mind being unplugged without the 
usual shutdown process, is extremely fast, and is far 
more versatile than any alternative Brian could find. 

Next, Brian needed to decide which board would 
work best for the Atari ST rebuild (see magpi.cc/ 
mt32picustom). He chose ClumsyMidi (magpi. 
cc/clumsyMIDI) because it is based entirely on 
through-hole parts which he was able to order 
along with the Clumsy circuit boards. 

Aside from the Atari ST, Brian estimates the 
project cost roughly $75 and came together very 
easily. There was one aspect that left him a little 
dissatisfied though. “If you're planning to mess 
around with making music on your Atari, you 
will have the most fun if you can compose using 
a real musical instrument rather than just using 
the software. So you'll want to build some practice 
and learning into your time budget. I say this as 
someone who has neglected that part and regrets it." 

Brian's Atari ST is used for both retro games and 
MIDI demos at the Rhode Island Computer Museum, 
where visitors can connect it to a keyboard and 
try out different instruments playing the freeware 
Sweet Sixteen sequencer (magpi.cc/si6atari). “It’s 
amazing how much fun someone can have switching 
instruments and banging on keys.” Ш 
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Making MIDI 


You don't need a vintage synth to try out 
mt32-pi. It can be used with a USB MIDI interface. 


If you are making your open hardware setup, 
you need to solder the ClumsyMIDI (or other 
chosen) board together, download the mt32-pi 
software from magpi.cc/mt32pigit and install it 
on to a spare microSD card. 


Place the MIDI board atop the Raspberry Pi and 
connect the five-pin DIN MIDI cables. Power on, 
and mt32-pi should boot within moments. You're ready 
to start experimenting with electro-synth music. 
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CoolCoral 
Project 


How do you cool ocean coral? A group of volunteers 
discuss this regularly and their current solution makes 
use of Raspberry Pi Pico. Rob Zwetsloot takes a look 


s the climate around the globe changes, device itself, its pumps and whatnot, while also 
nature itself is being affected. Ocean hosting a website." 
The web server is accessible remotely, not only 


reefs and their coral are just one of the 


lestyn 
Jones 


lestyn is an engineer 
with an interest in 
climate science. He's 
part of a volunteer 
group of people 
seeking to help 
researchers maintain 
coral for study. 


magpi.cc/ 
coolcoral 


P» The solar panels are 


currently not equipped, 
but would provide 
power to the system 


ecosystems under threat, so research into them 
is very important. 

“Field experiments involving coral in tropical 
climates are increasingly hampered by heatwaves 
- and that's a pleasant turn of phrase," Explains 
Iestyn Jones, a member of the volunteer group 
CoolCoral Project. “Basically, unpredictable 
heatwaves cause unpredictable temperature 
shifts that can overwhelm and, more often than 
not, kill coral samples and render oceanographic 
experiments fruitless.” 


These fatal heatwaves are becoming more regular 


due to global warming, however the device the 
group have been working on "concentrates 

cool water onto coral samples and alleviates the 
fatal effects". Water cooling for coral then, like a 
high-spec gaming PC. 

“Т?П be a solar-powered machine that'll be 
cooling sea-water temperatures and running a 
Raspberry Pi Pico for data readings and collection," 
Iestyn tells us. “It’s simple science -KS4, Га 
estimate - but it's a combination of ideas that's 
gone untested... until now!" 


Pico at sea 


Members of the team described the build process as 


“agile, rapid prototyping,” so it's no wonder they 
chose Pico for the job. 

*Not only is Raspberry Pi Pico extremely 
accessible and uncomplicated, but it offers a 
comprehensive range of functions and capabilities 
that our device requires,” Iestyn says. “For 
example, Pico's ability to run two different 
threads simultaneously allows us to run the 
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allowing easy access to data across the globe, but 
also to update the system thanks to the wireless 
connection on Pico W. The system itself does a lot 
more than take readings, though. 

*From the outside, the device looks like a 
wheelbarrow drawn by a three year old: it's a 
cumbersome brown box with handles and some 
dinky wheels but, inside, it's a toybox of entropy," 
Iestyn says. “Pumps take in seawater through a 
hose before sending it through a digestive tract 
of more hose, copper pipes and a ribbed- metal 
refrigeration unit that's filled with ice. It doesn't 
need saying that the water cools on this journey. 


Coral would be kept cool 
inside the wooden box 


Mádfi 


Members of the 
team previously 


worked on the Real 


Ice Project... 


„which looked 
at restoring and 
preserving Arctic 


sea ice: realice.eco 


CoralCooler will 
aid the study of 
marine biology. 


oceanography and 
climate science - to 


name just a few 


The analogue-to- 
digital converters 
on Pico allow for 


high precision data 


As well as data 
recording, Pico is 


great for pump and 


voltage control 


The various cooling 
mechanisms, pumps, 
and electronics are 
kept in the crate 


The current prototype is akin to a 
wheelbarrow, as the team puts it 
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P Serious battery power 
is required to keep 
the system going 
without solar panels 


Y The development 
involved a lot of rapid 
prototyping, a perfect 
use for Pico 


Eventually, the cooled seawater enters another 
6 external pipe that runs towards ће seabed and, 
< : hopefully, a chunk of coral that’s shivering its 
=~ — timbers over the prospect of a heatwave. 
| “Meanwhile, floating above the sea level in a 
hermetic box is our Raspberry Pi Pico. Up there, 
[Pico] is running constant temperature and 
\ icd performance readings which are being sent in real 
AIT | time towards a device connected to the Wi-Fi. If 
—— 4. anything goes awry, a notification is zapped across 
— theair and the device can be reeled in for repairs." 
TN The team has made sure that the mechanical 
= | aspects of the device can be fixed as easily as 
E possible, in fact all it requires is a single type of 
Š Ж; -~ spanner. “The whole thing, meanwhile, is being 
ES | powered by two enormous solar panel wings held 
afloat on either side of the device by rubber tyres, 
or buoyancy aides.” Iestyn says. 


m The device the group has been 


Prototyping stage 
WO rki ng on conce ntrates coo | water The device is still undergoing tests, with most 
' of the electrical and mechanical system done. 
onto cora | sam p les d nd d | levi ates th е Currently float tests are being conducted. 
fata | effe cts, Water cool | n g for CO ra | «Tf anything [it was] too successful," admits 
Iestyn. *With the device floating much higher than 
then, like a hi g h-spec ga min g PC E it needed to and answering the question: ‘Will we 


require ballast?" 


b Testing is meticulous to 
make sure everything 
works perfectly 
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Cooling coral 


Once all the testing and prototyping is finished 
and combined into a single test, the team reckon 
they'll start on a second model in the future based 
around their findings. 

*We're conscious that the CoolCoral Project is 
coming across as oppressively niche because, well, 
it's a machine that chills-out diddy clumps of coral 
- it's hardly carbon capture technology," Iestyn 
says [Ed note: we think it's very cool]. *However, the 
project is terribly exciting because of its flexibly 
multifaceted nature. There's already interest 
being shown towards utilising this device for 
experimenting with substrate microbes, and that 
interest isn't even concerning the coral-cooling 
part of it. A floating device that has the potential 
to store masses of energy is, frankly, unheard of 
in ocean sciences. Most ocean-based experiments 
running today require boats and diesel engines to 
run. Our machine uses solar panels! This is how 
untouched this kind of thing is! We're tinkering 
on the tip of a vast iceberg of possibilities when it 
comes to ocean-centric energy devices, and we're 
very excited to see where further experimentation TE 
can take us.” Ш front of the device 


Get the device into the water and prepare the 
coral sample you need to cool down. 


S 
NS 


Water is pumped through a refrigeration 
system and cooled before being pumped 
to the coral to make sure it too keeps cool. 


With enough power this cycle can be repeated 
indefinitely, which is where the large floating 
solar panels will come in eventually. 
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| SUBSCRIPTION 


SUBSCRIBE TODAY 
FOR JUST £10 


FREE Delivery 
Get it fast and for FREE 


Exclusive Offers 
Great gifts, offers, and discounts 


Great Savings 
Save up to 23% compared to stores 


Free Pico W 
3 issues of The MagPi 
£10 (UK only) 


Free PicoW 

6 issues of The MagPi 

£30 (UK) $43 (USA) 

€43 (EU) £45 (Rest of World) 


Subscribe by phone: 01293 312193 
Subscribe online: magpi.cc/subscribe 


Email: magpi@subscriptionhelpline.co.uk 
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SUBSCRIBE TODAY AND GETA 


A brand new RP2040- 
based Raspberry Pi Pico W 
development board 


Learn to code with 
electronics and build 


your own projects This is a limited 
offer. Not included 

with renewals. Offer 

Make your own home subject to change or 

automation projects withdrawal at any time. 

handheld consoles, 

tiny robots, and much, 

much more 


RASPBERRY PI Al 


MADE CLEAR - s - SUBSCRIBE 
ON on app stores 


4 Available on the 
& App Store 


Ё : e +o" es 
ry е 2 d 
s x "y CODI 
вне | А = 
= OAR 
UE ; | Fror n £2.29 GS 
LEARN TO CONTROL AN INDUSTRIAL ROBOT ARM 


P> Google Play 
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RASPBERRY PI AI 
MADE CLEAR 


GENERATE IMAGES WITHOUT INFRINGING 
COPYRIGHT, ADD NATURAL VOICES TO YOUR SCREEN 
READER, AND MEET A ROBOT DOG IN OUR GUIDE TO 

MACHINE LEARNING TOOLS FOR RASPBERRY PI 


K.G. 
Orphanides 


KG. is a writer 
and developer 


@owlbear 


) Raspberry Pi 20 


oe 


achine learning isn’t all confabulating 

chatbots and copyright-infringing 

image generators, but you’d be 
forgiven for thinking that in the current AI 
hype cycle. In this feature, we’ll look at your best 
choices for non-exploitative machine learning 
projects, fun toys and genuinely useful tools. 

We've previously looked at chatbot creation 
(Build your own GPT Chatbot, magpi.cc/129), both 
deploying popular online tools such as OpenAI's 
very much not open GPT models, as well as fully 
local, privacy-centric approaches to creating 
chatbots using models like Stanford University's 
Alpaca (fine-tuned from Meta's LLaMA). 

Some LLMs (large language models) include 
scrapes of the open internet, including web 
pages containing copyrighted material, GitHub 
repositories not having their licences respected, and 
were even found leaking personal data - something 
the LLaMA 2 training set was scrubbed of. 

We’ll steer clear of problematic models in this 
feature and do our best to ensure that we don't 
use any other models that contain unpleasant 
surprises. We've instead sought out open and 
public domain-based projects that can be run 
locally on your Raspberry Pi hardware. 

This approach allows us to understand more 
about machine learning and AI tools while 
minimising potential harm. 


The ethics of А! 

Much has been made of a hypothetical threat that 
general AI (the popular term for a ‘true’ artificial 
intelligence - however you choose to define that) 
could present to humanity's existence. 

This acts as a smokescreen for real ethical 

issues users in the field of machine learning must 
grapple with: the high power consumption involved 
in training AIs and using cloud-based models; 
unsustainable water use by the data centres where 
they're trained and used; worker exploitation in 
both labelling training data and content moderation 
for live systems, and copyright abuse in the form of 
model training data scraped from the open internet 


_ without consideration of licensing terms. 


N Users are led to expect authoritative answers, 
and many appear to assume LLMs in particular 
vill contain current information, even though they 


b can't regurgitate anything that happened after the 


“moc 5 training data cut-off date. 


y 


More significantly, what LLMs do is place words 
in a probable order based on their training - you 
might have heard them referred to as ‘stochastic 
parrots’. LLMs aren't given labelled training data but 
are instead fed a vast corpus of writing, and practice 
emulating the patterns therein. 

LLMs create probable text sequences, the result 
of a training process in which the model attempts 
to accurately predict the next word in a huge range 
of texts. What it spits out can be entertaining and 
even impressive, but an LLM can't analyse what 
you're asking, or its response. So we see lawyers 
citing cases that don't exist, chatbots spitting out 
confabulated stories of criminal acts, recommending 
made-up software packages that introduce supply 
chain vulnerabilities, or simply repeating popular 
misconceptions and plausible but inaccurate answers 
to unfortunate users who mistake them for a search 
engine or information repository. 
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О HOW TO USE MACHINE LEARNING 
TOOLS WITHOUT BEING GROSSLY 


UNETHICAL ABOUT IT @ 


Harm reduction 
So, how can we use machine learning tools without 
being grossly unethical about it? 

For a start, we'll be running everything locally on 
Raspberry Pi. That immediately limits your power 
consumption to about 6W (with Raspberry Pi 5) and 
ensures that you can keep your data to yourself. 

We'll do our best to use machine learning 
models and projects that use only public domain 
or consensually collected, opt-in, training data, 
and highlight any potential issues with others we 
mention. We'll similarly prioritise open models, 
where both training data and methodologies are 
publicly available, rather than opaque black boxes. 

And while it's hard to avoid mentioning at least 
a couple of machine learning tech behemoths, 
we want to explore projects that are more about 
small-scale ingenuity than speculative profits and 
influence for large tech firms. 

While ‘artificial intelligence’ is a misnomer at best 
the technologies that get bundled under the name 
are often fascinating. It’s also worth understanding 
what’s behind the latest craze sweeping the industry, 
and there’s no better way to learn than by doing. 


) 


Warning! 
Copyright 


We've used copyright- 
safe models for image 
generation throughout 
this feature, but most 
other diffuser models are 
trained on work scraped 
without permission and 
may infringe on living 
artists copyright. Read 
the section Text and 
data mining for non- 
commercial research. 


magpi.cc/copyright 
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Al PROJECT 


THESE BUILDS HELP YOU BRING А! 
INTELLIGENCE TO THE REAL WORLD 


magpi.cc/coral 
magpi.cc/teachmachine 


Coral's USB Accelerator lets you build AI 
capabilities into Raspberry Pi projects. The 
accelerator is built around Google's Edge TPU 
chip, an ASIC that greatly speeds up neural 
network performance on-device. 

We used Coral to build a Teachable Machine, 
a device that can be taught to recognise objects 
using Raspberry Pi, Coral USB, and a Raspberry Pi 
Camera for a complete system that's perfect for 
executing complex computer vision tasks such as 
object recognition. Since the Accelerator operates 
locally, you do not need to connect to a cloud 
service or share secure data over the internet. It 
also runs with less latency than a cloud connection, 
performing object detection in near real time. 


magpi.cc/braincraft 


Built for Raspberry Pi 4, Adafruit's Braincraft 
HAT is a pretty comprehensive kit for machine 
learning. It includes a 1.54-inch 240x240 TFT 
screen as a display, a joystick to navigate options 
you might wish to display on it, a cooling fan, 
three controllable LEDs, plus speaker, headphone 
and microphone ports to help you build text-to- 
speech tools or home assistant projects. There's 
no integrated camera, but it does include a slot 
to connect one, as well as a range of other IC2 and 
JST STEMMA devices. 

Adafruit publishes a range of projects targeting 
the Braincraft, and is currently updating its 
guides and software to support Raspberry PI OS 
Bookworm. The legacy version of Raspberry Pi 
OS Bullseye, which is known to be stable with the 
HAT, is available via both Raspberry Pi Imager and 
as a direct download. 
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Vizy Camera 
1 ziz 1 Luwu Dynamics’ XGO Mini 2 and Lite 2 dogs look 
like desk-sized takes on Boston Dynamics’ Spot 
robot. The robot can be addressed by a variety of 
microcontrollers and single-board computers, but 
the default configuration uses Raspberry Pi CM4. 

As well as manual control options, it has a 
selection of pre- programmed behaviour routines 
that you can invoke, including object recognition 
using the Yolo real-time object detection system, 
voice command recognition, and efforts at gender, 
emotion and gesture recognition. All of these 
behaviours are handled by a clutch of Python 
scripts and their accompanying libraries, which 
makes them really easy to customise. 

If you don't want to immediately dive into XGO's 
scripts, there are also a range of programming 
interfaces available and custom libraries for 
controlling the cyberdog body. Your options 
range from a remote control smartphone app to a 
Python-based block-based programming interface 
accessible via a web browser. 
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TRANSCRIPTION AND 


SPEECH 


ne of the most genuinely beneficial 

developments to have come from 

machine learning is the ability to run 
offline tools that can provide sophisticated, 
accurate text transcriptions of spoken word audio 
and which can read text for you. 

While the latter has unfortunately led to a boom 
in annoying synthetic-voiced videos, it's genuinely 
useful when under your control. We're going 
to install Speech Note (magpi.cc/speechnote), 

a capable neural speech synthesis text-to- 

speech (TTS), speech-to-text (STT) and machine 
translation tool that runs entirely locally to ensure 
your privacy, and set up the Orca screen reader 
with Piper TTS to give the accessibility tool a more 
modern feel. First, we'll set up Flatpak and install 
Speech Note via the terminal. 


Speech Note transcription 


$ sudo apt install flatpak 


$ flatpak remote-add --if-not-exists flathub 
https ://flathub.org/repo/flathub.flatpakrepo 


Now reboot Raspberry Pi, then open a terminal 
and type: 


$ flatpak install speechnote 


Say "yes" to confirm that you wish to use the 
suggested ref, that you wish to install it, and that 
you wish to proceed with the suggested changes to 
your system installation. 

Open SpeechNote from the Sound & Video menu, 
then go to the Languages menu, search for English 
(and any other language you may require) and 
select the models you wish to use. 

OpenAl’s Whisper is open-source, and 
transcription tools don’t carry the intellectual 
property violating baggage of text or image 
generators, so English Whisper Small should do 
the trick for Speech To Text. 

A number of Text To Speech models are 
available. We find Piper Alba Medium to be both 
easy on the ears and conveniently near the top 
of the list. 
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NTHESIS 


A few translation options are also available, but 
this list is limited to only one per language pair. 
You can try them out based on your translation 
requirements - we installed English to French and 
French to English - the latter was only available 
when we selected French in the first step of the 
Language installation workflow. Some punctuation 
checkers are also available, which can be helpful 
for language learners. Em. 

Download the following test file, which is four 
seconds of speech: magpi.cc/audiotestwav. 

In Speech Note, click File » Transcribe a file, and 
open the file we just downloaded. Transcription 
will begin automatically, and the transcribed text 
will be output in Speech Note's main text pane. 


Integrate Piper with Orca 

Piper speech synthesis is a clear upgrade from the 
eSpeak synthesised voices we're all familiar with. 
It's not yet available as a default option for many 
screen readers, but we can integrate it with Orca, 

the most mature Linux screen reader. 

Using Orca with Piper has its limitations, such 
as comparatively slow reading performance when 
working in a command terminal and requiring 
more system resources, but the more natural 
voice can make it more pleasant to work with 
if you're primarily interacting with a GUI via 
keyboard shortcuts. 


$ sudo apt install orca 
$ cd Software 


$ git clone https://codeberg.org/ 
MightyOwlbear/rpi-piper-tools.git 
$ sh install-spd-piper.sh 


Enter your password to install dependencies 
when prompted. 

Once installed - assuming the test audio was 
produced, it's time to configure the Orca screen 
reader to use Piper: 


In Orca’s settings tool, select the Voice tab. 
Under Speech synthesiser, select ‘piper-generic 


Screen Reader Prefer... efe Speech Note 


Brors ] 


Wastebasket 


Notepad 


Voice Type Settings 


Voice ty 


Global Voice Settings 


Speech Note is a single, fully 
local application for tools such 
as Whisper transcription, Piper 


We're using the Orca screen reader, 
to which we've added Piper neural 


TTS and translation 


Text-To-Speech 


m WE'RE GOING ТО INSTALL SPEECH 
NOTE, A CAPABLE NEURAL SPEECH 
SYNTHESIS TEXT-TO-SPEECH 
MACHINE TRANSLATION TOOL @ 


default voice! from the pu 
Untick the ‘Break speec 


ll-down menu. 
h into chunks between 


pauses’ box on the right, then click Apply. You 


may also wish to change t 
speaks - we like putting t 
You'll now be hearing a 


he Rate at which it 
his at 70. 
Piper voice named Alan 


narrating your interactions. It's worth noting that, 


if you're a quick typist, Pi 


per will not be able to 


keep up with your letter-by-letter text entry in the 


same way as eSpeak. 


Orca works with both Xorg and Wayland, but 


we've seen slightly better 


performance in X. If 


you're booting to command line and starting the 
GUI from there, simply invoke 


$ startx 


instead of 


$ wayfair 


If you're booting to the GUI, you'll have to 
change your config to reflect your preference. In a 
terminal type: 


$ sudo raspi-config 


Go to 6 Advanced Options » A6 Wayland » X1 X11 
and select OK. Reboot to enact your settings changes. 
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BUILD AN 
ARTIST-RESPECTING 
IMAGE DIFFUSER 


| You'll Need mage generation is a minefield if you're 
hoping to keep your use of machine learning 
> 8GB RAM ethical and cost-effective, as well as fun. 


(Note: may not work Services such as Midjourney and Dall-e are black 
on 4GB models) 


boxes to their users (you can't see what is going on 
» Large microSD card inside). Buying time on these services is costly to 
(EACE Tnt you, and also costly to the environment in terms of 
> Mitsua Diffusion One not only training the models in the first place but 
magpi.cc/mitsua also powering and cooling the data centres where 
> Python 3.10.6 they are run. 
(Note: Newer versions Many image generators also built on the work of 


ub eua Ee Ce living artists, without their consent, making them 


a huge problem. Fortunately, we're starting to see 

the emergence of image generation models trained 
on public domain material such as image galleries 

shared by museums, and artworks volunteered by 

their creators via an opt-in system. 


0 IMAGE GENERATION IS A MINEFIELD 
IF YOU'RE HOPING TO KEEP YOUR 
USE OF MACHINE LEARNING 
ETHICAL AND COST-EFFECTIVE 


For this tutorial, we've chosen Diffusion 
One (magpi.cc/mitsua), a Stable on- 
compatible text-to-image model trained 
exclusively on public domai t. Its licence 
requires that you don't bre one's copyright 
in fine-tuning the model, : at you don't pass 

^ Prompt: "ukiyo-e off its generated images -AI creations. 
E REND qn Hugging Face's Diff brary allows us to run 
work by reducing noise 


A Pro nist landscape in the style of Turner. 
are visible through clouds, illuminating the 
rees, river". Negative prompt: "people, animals" 


with snow, in the diffusion models - whi 
style of Hokusai". 


a Я until an image that г les their prompt appears 
egative prompt: E i i 
“people, animals" - оп almost any CPI re using Raspberry Pi 5. 
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Prompt: “а painting of ancient japa kyoto hu 
kiyomizu templ п impressionism painting, fine art’ "аг 
Negative prompt: “photo autumn, trees 


town < 


oil painting”. Negative prompt: "humar nimals, curves” 
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01 Set up your disk 

You'll need an 8GB Raspberry Pi 5 (or 
Raspberry Pi 4) with a 64GB microSD card. On 
a fresh install of Bookworm - we'll be running 
headless, so you can either disable booting to 
GUI or install the Lite version of Raspberry Pi OS. 
Before you burn your OS image to a microSD card 
in Raspberry Pi Imager, remember to enable SSH 
with password authentication, set a hostname, 
username and password and configure your 
wireless LAN if you need it. 

If you've installed the full GUI- enabled version 
of Raspberry Pi OS, you'll want to start by 
disabling that. SSH in or open a terminal and type: 


$ sudo raspi-config 


1 System Options » S5 Boot / Auto Login » B2 
Console Autologin 


Select Finish and say Yes to rebooting 


Configure swap 
If you don't have at least 8GB of swap 


space - extra working space on your microSD card 
for when you run out of RAM - Diffusers will fail 
to output the image after processing. Note that this 
can wear out your microSD card faster than you'd 
otherwise expect. 


$ sudo dphys-swapfile swapoff 
$ sudo nano /etc/dphys-swapfile 


In nano, we’ll edit the swapsize and the 
maxswap entries to give us 8GB of swap and no 
limit on swap size: 


CONF SWAPSIZE-8192 
CONF MAXSWAP- 


Hit CTRL + X and Y. Then, back at the 
command prompt: 


$ sudo dphys-swapfile setup 
$ sudo dphys-swapfile swapon 


$ reboot 
03 Large-scale cloning 
Now, a few dependencies before we 
get started. First, we'll need to add large file 
support to git: 
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$ curl -s https://packagecloud.io/install/ 
repositories/github/git-lfs/script.deb.sh | 
sudo bash 

$ sudo apt install git-lfs 


Initialise it: 


$ git-lfs install 


Create a home for our model and download it: 


$ mkdir -p Software/models && cd Software/ 
models 

$ git clone https://huggingface.co/Mitsua/ 
mitsua-diffusion-one 


While not particularly large by the standards of 
diffusion models, Mitsua Diffusion One still clocks in 


at around 6GB, so this operation might take a while. 
You've gotta keep 'em 


04 separated 


To use Hugging Face Diffusers, you'll need 
PyTorch, which requires a maximum version of 
Python 3.10.6 - rather older than the current 
version available in repos. We'll use pyenv to install 
it, and the virtualenv command to ensure that we 
lock our working environment to the right version 
of Python and keep all the relevant dependencies 
siloed. This ensures that nothing we do here will 
have an impact on anything else we have installed 
or our system- wide software defaults. 


$ cd 


$ curl https://pyenv.run | bash 


You'll be prompted to add shortcuts to your bash 
profiles to invoke pyenv from the command line. 


05 Update your profile 


In terminal, enter: 


$ nano ~/.bashrc 


Add the following block to the bottom of the file, 
and save with CTRL+X. 


echo ‘export PYENV ROOT-"$HOME/.pyenv"? >> 
~/.bashrc 


echo ‘command -v pyenv >/dev/null || export 
PATH=”$PYENV_ROOT/bin:$PATH”? >> ~/.bashrc 
echo ‘eval “$(pyenv init -)”’ >> ~/.bashrc 


Now edit the .profile file: 


$ nano ~/.profile 


As above, add this block to the bottom of the 
file, and save: 


echo ‘export PYENV ROOT-"$HOME/.pyenv"? >> 

~/.profile 

echo ‘command -v pyenv >/dev/null || export 
PATH=”$PYENV_ROOT/bin:$PATH”’? >> ~/.profile 

echo ‘eval “$(pyenv init -)”’ >> ~/.profile 


Now reload your bash profile, thus: 


$source ~/.bashrc 


06 Python depends on you 


We're going to use pyvenv to install 
the right version of Python, but we have some 
dependencies to install first. We've split these 
into three comments for ease of copying, but you 
can string them into a single apt install command if 
you prefer. 


$ sudo apt install zlib1g zlibig-dev libssl-dev 
libbz2-dev libsqlite3-dev 

$ sudo apt install libedit-dev libncurses5-dev 
liblzma-dev 

$ sudo apt-get install libreadline-dev libffi-dev 


And now we can install the correct Python version, 
corralled by pyenv. 


$ pyenv install 6 


Virtual environment 

As another important step to maintaining 
an air gap between multiple Python setups, we're 
going to create a virtual environment, in which 
we'll install 


$ pyenv virtualenv 3.10.6 venv diffusion 


Now we'll activate it. You'll have to repeat this step 
every time you want to use our diffusion script. 


$ pyenv activate venv diffusion 


The command prompt will now be tagged 
(venv. diffusion) We'll install the software we need to 
invoke our model. 


$ cd Software 

$ git clone https://codeberg.org/MightyOwlbear/ 
Raspberry-Pi-5-Diffusion.git 

$ cd Raspberry-Pi-5-Diffusion 


$ nano python mitsua app.py 


08 Nearly there 
Enter: 


$ cd Software 

$ git clone https://codeberg.org/MightyOwlbear/ 
Raspberry-Pi-5-Diffusion.git 

$ cd Raspberry-Pi-5-Diffusion 


$ nano python mitsua app.py 
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TopTip ò 


Don't forget 
to activate 


Type pyenv 
activate venv 
diffusion to 
activate your 
virtual environment. 


On line 9, check to make sure the path matches 
the one you downloaded Mitsua Diffusion One 
model to. In our sample script, we've worked with 
the username 'pi' and otherwise used the directory 
structure described in this tutorial. Press CTRL+X 
to quit and save when prompted. 


$ python mitsua app.py 


You'll be asked to supply a prompt for the model: 
a description of the image you'd like it to produce. 
You’ll then be asked for negative prompts: anything 
you don't want the image to include, from an 
object, to a colour, to a trait such as blurriness or 
fused fingers, or a style, such as a photo. 

The first time you run this script will take the 
longest. If everything's configured correctly, however, 
a standard run should take under 15 minutes, and will 
produce a time-stamped output file. 


Line, please 

As it is trained on public domain material, 
primarily from museums and art galleries, plus 
Wikimedia Commons and public domain subsets of 
various image sharing sites, Mitusa Diffusion One 
has specific strengths and weaknesses. 

You'll have more luck getting it to produce 
somewhat convincing images of woodblock prints, 
engravings, impressionism, and fine art paintings 
than photographs. We never got it to give us a 
really convincing picture of a cat. 

To get the best results, we’ve found it useful to 
name specific artists and styles. As large parts of 
its training data come from art gallery collections, 
it’s worth browsing, for example, the Art Institute 
of Chicago’s collection (magpi.cc/aicpub) to find 
some inspiration. 

Illustrating this article, you'll find examples of 
prompts and the images they produced. (1 


Generate image descriptions 


Image description is incredibly important on the 
modern internet. Image alt text descriptions are, 

first and foremost, essential for blind and partially- 
sighted internet users, but also for anyone interacting 
with the web using text, including RSS feeds and text 
browsers like Lynx. 

While hand-crafted alt text is better than something 
automated, not everyone finds it easy to write. And 
sometimes you might need a tool to quickly describe 
an image to you for your own reasons. This project uses 
the same Python venv and directory structure we set 
up for our copyright-safe image generation project, and 
uses Salesforce's BLIP (Bootstrapping Language-Image 
Pre-training) image description model (magpi.cc/ blip). 

If you prefer not to use machine learning tools from 
tech giants, Salesforce might be one you'd rather avoid. 
A paper describing BLIP's development (magpi.cc/ 
blippdf) indicates that its training is based on image 
and alt text pairs scraped from the web, which are then 
filtered to avoid 'noisy' captions. The filtering process 
and very limited length of the generated captions 
make the likelihood of generating copyright-infringing 
content minimal, but the training methodology should 
be taken into account if you intend on using captions 
generated by BLIP. 

We'll start by downloading the model and image 
description script. 
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twinery.org 


$ cd ~/Software/models 

$ git-lfs install 

$ git clone https://huggingface.co/ 
Salesforce/blip-image-captioning-base 

SS el os 

$ git clone https://codeberg.org/ 
MightyOwlbear/blip-image-description-tool.git 
$ cd blip-image-description-tool 

$ nano captioner.py 


Check the paths to make sure they match the location 
of your model - if your user isn't called ‘pi’, you'll need to 
change this. Press CTRL * X to save and exit nano. 


$ pyenv activate venv diffusion 
$ python captioner.py 


This version of the captioner only accepts web 
addresses for its image targets. To test it, you can use 
the following image URL: magpi.cc/gullsjpg. This 
should produce a description that reads: “a group of 
birds flying in the sky". 


FEATURE | MägPi MEM 


DOWNLOAD 
mitsua-app.py THE FULL CODE: 


from diffusers import StableDiffusionPipeline 


from PIL import Image Top Tip 


import datetime 

The htop 
prompt - put(“Describe the image you want: “) 

negative prompt - ("Describe traits to avoid - e.g. If you have a 


ted 
blurry, fused hands: “) Pur. 


Pi, you can run 
it insert path to Mitsua Diffusion One below htop to monitor 
memory and 


pipe = StableDiffusionPipeline.f 1 (*/home/pi/ 
swap consumption. 


Software/models/mitsua-diffusion-one/", 
low cpu mem usage-True) 
pipe = pipe.to(“cpu”) 


image = | (prompt, negative_prompt=negative_prompt, 
num inference steps-31, width-400, height-400).images[0] 


# timecode every output image so they can’t overwrite each 
other 

created - datetime.datetime.now().s me (“%Y%m%d%H%M%S” ) 
image. (“output-” + created + “.png”) 


. DOWNLOAD 
captioner.py THE FULL CODE: 


import requests 

from PIL import Image 

from transformers import BlipProcessor, 
BlipForConditionalGeneration 


# insert the path to your model’s directory in both of the 
following lines 

processor - BlipProcessor. ^ained(*/home/pi/Software/ 
models/blip-image-captioning-base/") 

model - BlipForConditionalGeneration. e (“/һоте/ 
pi/Software/models/blip-image-captioning-base/") 


img url - (“Enter JPG image URL: ©) 
raw image - Image.open( 
requests.get(img url, stream=True).raw). егі( “КСВ? ) 


inputs = ssor(raw image, return tensors-"pt") 


out - model. (**inputs, max new tokens-1000) 


(processor. (out[0], skip special tokens-True)) 
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Gareth 
Halfacree 


Gareth is a freelance 
technology journalist, 
writer, and former 
system administrator 
in the education 
sector with a passion 
for open-source 
software and 
hardware, 


freelance. 
halfacree.co.uk 


Using your 
Raspberry P1 


Learn about the Raspberry Pi operating system 


Press 'Next to get started. 


Figure 1. 
The Welcome Wizard 


our Raspberry Pi can run a wide range of 

software, including a number of different 

operating systems - the core software 
that makes a computer run. The most popular 
of these, and the official operating system of 
Raspberry Pi, is Raspberry Pi OS. Based on 
Debian Linux, it is tailor- made for Raspberry Pi 
and comes with a range of extra software pre- 
installed and ready to go. 

If you've only ever used Microsoft Windows 
or Apple macOS, don't worry: Raspberry Pi OS 
is based on the same intuitive windows, icons, 
menus, and pointer (WIMP) principles, and 
should quickly become familiar. 

The first time you run Raspberry Pi OS, 
you!ll see the Welcome Wizard (Figure 1). This 
helpful tool will walk you through changing 
some settings in Raspberry Pi OS, known as the 
configuration, to match how and where you will 
be using your Raspberry Pi. 

Click the Next button, then choose your country, 
language, and time zone by clicking on each 
drop-down box in turn and selecting your answer 
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Welcome to the Raspberry Pi Desktop! 


Before you start using it, there are a few things to set up 


If you are using a Bluetooth keyboard or mouse, put them into 
pairing mode and wait for them to connect 


Click Next to begin 
the Raspberry Pi OS 
setup process 


Set Country 


Enter the details of your location. This is used to set the 

anguage, time zone, keyboard and other international settings 
Country United Kingdom 
Language British English 
Timezone: Belfast 


Use English language Use US keyboard 


Press 'Next' when you have made your selection 


А Figure 2: Selecting a language, among other options 


from the list (Figure 2). If you are using a US- 
layout keyboard, click on the check box to make 
sure Raspberry Pi OS uses the correct keyboard 
layout. If you want the desktop and programs to 
appear in English, regardless of your country's 
native language, click on the Use English language 
checkbox to tick it. When you're finished, click Next. 


Y Figure 3: Setting a new password 


Create User 
You need to create a user account to log in to your Raspberry 
Pi 


The username can only contain lower-case letters, digits and 
hyphens, and must start with a letter. 


Enter username: gareth 


Enter password — 
Confirm password өөө 
v Hide characters 


Press 'Мехї to create your account 


Back 


The next screen will ask you to choose a name 
and password for your user account (Figure 3). 
Choose a name - it can be anything you like, but 
it must start with a letter and can only contain 
lower-case letters, digits, and hyphens. Then 
you'll need to create a memorable password. You’ ll 
be asked to type the password twice to make sure 
you didn’t make any mistakes that could lock you 
out of your new account. When you’re happy with 
your choices, click Next. 

The following screen will allow you to choose 
your Wi-Fi network from a list (Figure 4). 

Scroll through the list of networks with the 
mouse or keyboard, find your network’s name, 
click on it, then click Next. Assuming that your 
wireless network is secure (it really should be), 
you’ll be asked for its password (also known as 
its pre-shared key). If you don’t use a custom 
password, the default is normally written on a 
card that comes with the router, or on the bottom 
or back of the router itself. Click Next to connect 


Select Wireless Network 
Select your wireless network from the list 
chromecast 


Coffeeshop 
Event Booking 


Press 'Next to connect, or 'Skip' to continue without connecting. 


Back Skip Next 


А Figure 4: Choosing a wireless network 


Y Figure 5: Selecting a browser 


Choose Browser 


Both the Chromium and Firefox web browsers are preinstalled 
on Raspberry Pi OS. Select the one you prefer to use 


*› Chromium _ Firefox 


Tick here to uninstall the unused browser 


Press 'Next' when you have chosen a browser. 


to the network. If you don't want to connect to a 
wireless network, click Skip. 

Next, you will be asked to choose your default 
web browser from the two preinstalled in 
Raspberry Pi OS: Google's Chromium, the default, 
and Mozilla’s Firefox (Figure 5). For now, just 
leave Chromium selected as the default, so you 
can follow along with this book; you can always 
switch to Firefox later, if you'd prefer. If you do 
change the default browser, you can also choose to 
uninstall the non-default browser to save space on 
your microSD card. Just tick the box when you are 
offered the option, and click the Next button. 

The next screen will allow you to check for 
and install updates for Raspberry Pi OS and 
the other software on Raspberry Pi (Figure 6). 
Raspberry Pi OS is regularly updated to fix bugs, 
add new features, and improve performance. To 
install these updates, click Next. Otherwise, click 
Skip. Downloading the updates can take several 
minutes, so be patient. 


Update Software 
The operating system and applications will now be checked and 
updated if necessary. This may involve a large download 


Press 'Next to check and update software, or 'Skip' to continue 
without checking 


А Figure 6: Checking for updates 
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| You'll Need 


» Raspberry Pi 


» Raspberry Pi OS 


Warning! 
Power supply 


If, after your Raspberry 
Pi starts up, you seea 
message in the top-right 
corner telling you "this 
power supply is not 
capable of supplying 5A." 
it means you're using 
a power supply which 
can't supply the 5V at 5A 
required by Raspberry Pi 5. 
You should replace your 
power supply with one 
supporting Raspberry Pi 5, 


magpi.cc/power 


TopTip è 


Wireless 
networking 


Built-in wireless 
networking is 

only available on 
Raspberry Pi 3, 
Raspberry Pi 4, 
Raspberry Pi 5, and 
Raspberry Pi Zero 
W and Zero 2 W 
amilies. If you want 
О use a different 
model of Raspberry 
Pi with a wireless 
network, you'll need 
a USB Wi-Fi adapter. 
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P» Figure 7: Restarting 
Raspberry Pi 


Y Figure 8: The 
Raspberry Pi OS 
desktop 


oO ff Onn 1] 


M c 


Setup Complete 


Your Raspberry Pi is now set up and ready to go 


Press 'Restart to restart your Raspberry Pi and launch the 
desktop. 


Restart 


When the updates are installed, a window 
saying ‘System is up to date’ will appear; click 
the OK button. 

The final screen of the Welcome Wizard (Figure 7) 
provides one last bit of information: certain changes 
made will only take effect when you restart your 
Raspberry Pi (a process also known as rebooting). 
Click the Restart button and your Raspberry Pi will 
restart. From now on, the Welcome Wizard won't 
appear; its job is done, and your Raspberry Pi is 
ready to use. 


Navigating the desktop 

The version of Raspberry Pi OS installed on 

most Raspberry Pi boards is properly known as 
*Raspberry Pi OS with desktop', referring to its 
main graphical user interface (Figure 8). The bulk 
of this desktop is taken up with a wallpaper picture 
(A in Figure 8), on top of which the programs 

you run will appear. At the top of the desktop is 

a taskbar (B), which allows you to launch your 
installed programs. These are then indicated by 
tasks (C) in the taskbar. 


Raspberry РУ. Overman 


EG 
D 


x + 
Г] Raspberry Pi 


Raspberry Pi [5] 


The everything computer. Optimised 
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Wallpaper 
Taskbar 
Task 
System Tray 
Software Update icon 
Media eject 
Bluetooth icon 
. Network icon 
Volume icon 
Clock 
Launcher 
Menu (or Raspberry Pi icon) 
. Wastebasket icon 
Removable drive icon 
Window title bar 
Minimise 
Maximise 
Close 


PONTOZEP AUS RAMA RP 


The right-hand side of the menu bar houses 
the system tray (D). The software update icon (E) 
appears only when there are updates to Raspberry 
Pi OS and its applications. If you have any 
removable storage, such as USB memory sticks, 
connected to Raspberry Pi you’ll see an eject 
symbol (F); click this to safely eject and remove 
them. On the far right is the clock (J); click it to 
bring up a digital calendar (Figure 9). 

Next to this is a speaker icon (I in Figure 8). Click 
on it with the left mouse button to adjust audio 
volume, or click with the right mouse button to 
choose which output Raspberry Pi should use for its 
sound. Next to that is a network icon (Н); if you’re 
connected to a wireless network you’ll see the signal 
strength displayed as a series of bars, but if you’re 
connected to a wired network you’ll just see two 
arrows. Clicking the network icon will bring up a 
list of nearby wireless networks (Figure 10), while 
clicking on the Bluetooth icon (G) next to that will 
allow you to connect to a nearby Bluetooth device. 

The left-hand side of the menu bar is home to 
the launcher (К), which is where you'll find the 
programs installed alongside Raspberry Pi OS. 


» TL Ф 1130 


August 


123 4 5 6 
7 8 9 10 n 12 13 
14 15 16 17 18 19 20 
л 22 23 Ef) 25 26 27 
28 29 30 31 


A Figure 9: The digital calendar 


» T a) 5e 


Tum Off Wireless LAN 
Private Router 

Private Router 5GHz 
Private Router 5GHz-2 
TP-Link 33BF 

TP-Link 33BF. 5G 
More Networks 


Advanced Options 


А Figure 10: Listing nearby wireless networks 


Some of these are visible as shortcut icons; others 
are hidden away in the menu, which you can bring 
up by clicking the Raspberry Pi icon (L) to the far 
left (Figure 11). 

The programs in the menu are split into 
categories. Each category's name tells you what to 
expect: the Programming category contains software 
designed to help you write your own programs while 
Games will help you while away the hours. 

Not every program will be detailed in this guide, 


so feel free to experiment with them to learn more. 


On the desktop, you'll find the Wastebasket (M) 
and any external storage devices (N) connected to 
your Raspberry Pi. 


Xs 
o Programming 
*; Office 

Ө їгїегпеї 

Н Sound & Video 
7 Graphics 


FE Games 


» Accessories 


== | Preferences 
ZI Run 


В shutdown 


А Figure 11: The Raspberry Pi menu 


The Chromium web browser 

To practice using your Raspberry Pi, start by 
loading the Chromium web browser: click on the 
Raspberry Pi icon at the top-left to bring up the 
menu, move your mouse pointer to select the 
Internet category, and click on Chromium Web 
Browser to load it. 

If you've used Google's Chrome browser on 
another computer, the Chromium browser will 
be immediately familiar. Chromium lets you 
visit websites, play videos, games, and even 
communicate with people all over the world on 
forums and chat sites. 
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2 The Programming category contains 
software to write your own programs Л 


Start using Chromium by maximising its 
window so it fills the screen: find the three icons 
at the top-right of the Chromium window title 
bar (О) and click on the middle, up-arrow icon 
(Q). This is the maximise button. To the left 
of maximise is minimise (P), which will hide a 
window until you click on it in the taskbar at 
the top of the screen. The cross to the right of 
maximise is close (R), which does exactly what 
you'd expect: it closes the window. 

The first time you run the Chromium web 
browser, the Raspberry Pi website should load 
automatically, as shown in Figure 12. If not (or to 
visit other websites), click in the address bar at 
the top of the Chromium window - the big white 
bar with a magnifying glass on the left-hand side 
- and type raspberrypi.com (or the address of the 
website you want to visit), then press the ENTER 
key on your keyboard. The Raspberry Pi website 
will load. 

You can also type searches into the address bar: 
try searching for ‘Raspberry Pi’, ‘Raspberry Pi OS’, 
or ‘retro gaming’. 

The first time you load Chromium, it may bring 
up several tabs along the top of the window. To 
switch to a different tab, click on it; to close a tab 
without closing Chromium itself, click the cross on 
the right-hand side of the tab you want to close. 


8 Raspberry Pi 


Raspberry Pi (5) 


everything comp: ised. 


Computing 
for everybody 


From industries large and small, to the kitchen table tinkerer, to the. 


TopTip ё 


Shutdown 
safely 


Never remove the 
power cable from a 
Raspberry Pi or turn 
he power supply off 
at the wall without 
shutting down first. 
Doing so is likely 

o corrupt the 
operating system, 
and you could also 
ose any files you 
have created or 
downloaded. 


Figure 12: The 
Raspberry Pi 
website in Chromium 
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Close and 
save 


Closing a window 
before you've saved 
any work you've 
done is a bad 

idea; while many 
programs will warn 
you to save when 
you click the close 
button, others won't. 


Y Figure 13: The 
file manager 


File Edit View Sort Go Tools 


m m E ie 
EJ Home Folder 
Filesystem Root 


~ 

‚шып 

> роо! 

› деу 

» ес 

~ jhome 

~ EJ gareth 

[Bookshelf 
Desktop 
Documents 
К Downloads 
{Music 
D Pictures 
[Public 
[Templates 
[Videos 

> | lib 


9 items (14 hidden) 


To open a new tab, which is a handy way of 
having multiple websites open without having to 
juggle multiple Chromium windows, either click 
on the tab button to the right of the last tab in the 
list, or hold down the CTRL key on the keyboard 
and press the T key before letting go of CTRL. 

When you're finished with Chromium, click the 
close button at the top-right of the window. 


The File Manager 

Files you save - for example, programs, videos, 
images - all go into your home directory. To see 
the home directory, click on the Raspberry Pi icon 
again to bring up the menu, move the mouse 
pointer to select Accessories, then click on File 
Manager to load it (Figure 13). 

The File Manager lets you browse the files and 
folders, also known as directories, on Raspberry 
Pi's microSD card, as well as those on any 
removable storage devices - like USB flash drives 
- you have connected to your Raspberry Pi's USB 
ports. When you first open it, it automatically goes 
to your home directory. In here you'll find a series 
of other folders, known as subdirectories, which 
- like the menu - are arranged in categories. The 
main subdirectories are: 


1. Bookshelf - This contains digital copies of books 
and magazines from Raspberry Pi Press. You can 
read and download books with the Bookshelf 
application in the Help section of the menu. 


2. Desktop - This folder is what you see when 
you first load Raspberry Pi OS. If you save a file 


gareth 


M~ | /home/gareth 


Music Pictures 


Free space: 105.9 GiB (Total: 116.9 GiB) 
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А Figure 14: Inserting a removable storage device 


in here it will appear on the desktop, making it 
easy to find and load. 


3. Documents - Home to most of the text files 
you'll create, from short stories to recipes. 


4. Downloads - When you download a file from 
the internet using the Chromium web browser, 
it will be automatically saved in Downloads. 


5. Music - Any music you create or download can 
be stored here. 


6. Pictures - This folder is specifically for pictures, 
known in technical terms as image files. 


7. Public - While most of your files are private, 
anything you put in Public will be available to 
other users of your Raspberry Pi, even if they 
have their own username and password. 


8. Templates - This folder contains any 
templates - blank documents with a basic 
layout or structure already in place - which 
have been installed by your applications or 
created by you. 


9. Videos - A folder for videos, and the first 
place most video-playing programs will check 
for content. 


The File Manager window itself is split into two 
main panes: the left pane shows the directories on 
your Raspberry Pi, and the right pane shows the 
files and subdirectories of the directory selected in 
the left panel. 

If you plug a removable storage device into the 
Raspberry Pi's USB port, a window will pop up 
asking if you'd like to open it in the File Manager 
(Figure 14). Click OK and you'll be able to see its 
files and directories. 
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You can easily drag and drop files between 
Raspberry Pi's microSD card and a removable 
device. With your home directory and the removable 
device open in separate File Manager windows, 
move your mouse pointer to the file you want to 
copy, click and hold the left mouse button down, 
slide your mouse pointer to the other window, and 
let go of the mouse button (Figure 15). 

An easy way to copy a file is to click once on the 
file, click the Edit menu, click Copy, click the other 
window, then click the Edit menu and click Paste. 

The Cut option, also available in the Edit menu, 
is similar, but it deletes the file from its original 
home after making the copy. Both options can also 
be used through the keyboard shortcuts CTRL«C 
(copy) or CTRL+X (cut), and CTRL+V (paste). 

When you've finished experimenting, close the 
File Manager by clicking the close button at the 
very top-right of the window. If you have more 
than one window open, close them all. If you 
connected a removable storage device to your 
Raspberry Pi, eject it by clicking the eject button 
at the top-right of the screen, finding it in the list, 
and clicking on it before unplugging it. 


The Recommended Software tool 
Raspberry Pi OS comes with a wide range of 
software already installed, but your Raspberry Pi is 
compatible with even more. A selection of the best 
of this software can be found in the Recommended 
Software tool. 

Note that the Recommended Software tool needs 
a connection to the internet. If your Raspberry Pi 
is connected, click on the Raspberry Pi icon, move 
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your mouse pointer to Preferences, and click on 
Recommended Software. The tool will load and start 
downloading information about available software. 

After a few seconds, a list of compatible software 
packages will appear (Figure 16). These, like the 
software in the Raspberry Pi menu, are arranged 
into various categories. Click on a category in the 
pane on the left to see software from that category, 
or click All Programs to see everything. 

If a piece of software has a tick next to it, 
it’s already installed on your Raspberry Pi. If it 
doesn’t, you can click on the check box next to it 
to add a tick and mark it for installation. You can 
mark as many pieces of software as you like before 
installing them all at once, but if you’re using a 
smaller-than-recommended microSD card you 
may not have room for them all. 

Some versions of Raspberry Pi OS come with 
more software installed than others. If the 
Recommended Software Tool says Code the 
Classics is already installed - if there's already a 
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Eject devices 


Always use the 
eject button before 
unplugging an 
external storage 
device. If you don't, 
the files on it may 
become corrupt 
and unusable. 
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Save your 
work 


Get in the habit of 
saving your work, 
even if you haven't 
finished it yet. It 
will save you a lot 
of trouble if there's 
a power cut and 
you're interrupted 
part-way through! 


P Figure 17: Selecting 
Code the Classics 
for installation 


Y Figure 18: Installing 
Code the Classics 
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tick in the checkbox - you can choose something 
else from the list to install instead. 

There’s software available for Raspberry Pi 
OS to perform a wide range of tasks, including a 
selection of games written for the book Code the 
Classics, Volume 1 - a walk through the history of 
gaming which teaches you how to write your own 
games in Python, available at store.rpipress.cc. 

To install the Code the Classics games, click 
on the checkbox next to Code the Classics to 
tick it; you may need to scroll down the list of 
applications to see it. You'll see the text (will be 
installed) appear to the right of the application you 
selected, as shown in Figure 17. 

Click Apply to install the software; you'll be 
asked to enter your password. It will take up to a 
minute, depending on the speed of your internet 
connection, to install (Figure 18). Once the process 
is finished, you'll see a message telling you that 
installation is complete. Click OK to close the 
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'* Figure 19: The LibreOffice Writer program 
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dialogue box, then click the Close button to close 
the Recommended Software tool. 

If you change your mind about software you've 
installed, you can free up space by uninstalling it. 
Just load the Recommended Software tool again, find 
the software in the list, and click the checkbox to 
remove the tick. When you click Apply, the software 
will be removed, but any files you've created with it 
and saved in your Documents folder will remain. 

Another tool for installing or uninstalling 
software, the Add/Remove Software tool, can be 
found in the same Preferences category of the 
Raspberry Pi menu. This offers a wider selection of 
software beyond the list of recommended software. 


The LibreOffice productivity suite 

For another taste of what Raspberry Pi can do, 
click on the Raspberry Pi icon, move your mouse 
pointer to Office, and click on LibreOffice Writer. 
This will load the word processor portion of 
LibreOffice (Figure 19), a popular open-source 
productivity suite. 

If you don't have an Office category in your 
Raspberry Pi menu, or if you can't find LibreOffice 
Writer in there, it may not be installed. Go back 
to the Recommended Software tool and install it 
there before proceeding with this section. 

A word processor lets you write and format 
documents: you can change the font style, colour, 
size, add effects, and even insert pictures, charts, 
tables, and other content. A word processor 
also lets you check your work for mistakes, 
highlighting spelling and grammar problems in 
red and green respectively as you type. 


Begin by writing a paragraph so you can 11. LibreOffice Calc - A spreadsheet: a tool for 
experiment with formatting. If you're feeling handling numbers and creating charts and 
particularly keen, you could write about what graphs. 
you've learned about Raspberry Pi and its software 
so far. Explore the different icons at the top of the 12. LibreOffice Draw – An illustration program: a 
window to see what they do: see if you can make tool for creating pictures and diagrams. 
your writing bigger and change its colour. If you're 
not sure how to do this, simply move your mouse 13. LibreOffice Impress - A presentation program: 
pointer over each icon to display a 'tool tip! telling for creating slides and running slideshows. 
you what that icon does. When you're satisfied, 
click the File menu and the Save option to save 14. LibreOffice Math - A formula editor: for creating 
your work (Figure 20). Give it a name and click the properly-formatted mathematical formulae 
Save button. which can be used in other documents. 

LibreOffice Writer is only part of the overall 
LibreOffice productivity suite. The other parts, LibreOffice is also available for other computers 
which you'll find in the same Office menu category and operating systems. If you enjoy using it on 
as LibreOffice Writer, are: your Raspberry Pi, you can download it for free 

from libreoffice.org and install it on any Microsoft 
10. LibreOffice Base – A database: a tool for Windows, Apple macOS, or Linux computer. You 
storing information, looking it up quickly, and can close LibreOffice Writer by clicking the close 
analysing it. button at the top-right of the window. 
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Getting help 


Most programs 
include a Help 
menu which has 
everything from 
information about 
what the program 
is to guides on 
how to use it. If you 
ever feel lost or 
overwhelmed by a 
program, look for 
the Help menu to 
reorient yourself. 


9 Figure 20: Saving 
a document 
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Raspberry Pi Configuration tool 

The last program you’ ll learn about in this chapter 
is known as the Raspberry Pi Configuration tool, 
and it’s a lot like the Welcome Wizard you used at 
the start: it allows you to change various settings 
in Raspberry Pi OS. Click on the Raspberry Pi icon, 
move your mouse pointer to select the Preferences 
category, then click on Raspberry Pi Configuration 
to load it (Figure 21). 

The tool is split into five tabs. The first of these 
is System: this allows you to change the password 
of your account, set a host name - the name your 
Raspberry Pi uses on your local wireless or wired 
network - and alter a range of other settings, 
including choosing a default web browser. The 
majority of these shouldn't need changing. Click 
on the Display tab to bring up the next category. 
Here you can alter the screen display settings, if 
needed, to suit your TV or monitor. 

The Interfaces tab offers a range of settings, 
all of which (except for Serial Console and Serial 
Port) start off disabled. These settings should only 
be changed if you're adding new hardware, and 
even then only if instructed by the hardware's 
manufacturer. The exceptions to this rule are SSH, 
which enables a ‘Secure Shell’ and lets you log 
into Raspberry Pi from another computer on your 
network using an SSH client; VNC, which enables 
a ‘Virtual Network Computer’ and lets you see and 
control the Raspberry Pi OS desktop from another 
computer on your network using a VNC client; and 
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Cancel 


Remote GPIO, which lets you use Raspberry Pi's 
GPIO pins. 

Click on the Performance tab to see the fourth 
category. Here you configure the overlay file 
system, which is a way to run your Raspberry Pi 
without writing changes to the microSD card. It's 
not something you'll need to do in most cases, so 
most users can just leave this section as-is. 

Finally, click on the Localisation tab to see the 
last category. Here you can change your locale, 
which controls things like the language used in 
Raspberry Pi OS and how numbers are displayed; 
change the time zone; change the keyboard layout; 
and set your country for Wi-Fi purposes. For 
now, though, just click on Cancel to close the tool 
without making any changes. 


Software updates 
Raspberry Pi OS receives frequent updates, which 
add new features or fix bugs. If Raspberry Pi is 
connected to a network via an Ethernet cable or 
Wi-Fi, it will automatically check for updates and 
let you know if any are ready to be installed with a 
small icon in the system tray (it looks like an arrow 
pointing down into a tray, surrounded by a circle). 
If you see this icon at the top-right of your 
desktop, there are updates ready to install. Click 
the icon then click Install Updates to download 
and install them. If you'd prefer to see what the 
updates are first, click Show Updates to see a list 
(Figure 22). 


© $ TL « 125 


Show Updates... 


X 
Install Updates 


The time it takes to install updates varies 
depending on how many there are and how fast 
your internet connection is, but it should only take 
a few minutes. After the updates are installed, 
the icon will disappear from the system tray until 
there are more updates to install. 

Some updates are designed to improve the 
security of Raspberry Pi OS. It's important to use 
the software update tool to keep your operating 
system up-to-date! 


Shutting down 

Now you've explored the Raspberry Pi OS desktop, 
it's time to learn a very important skill: safely 
shutting your Raspberry Pi down. Like any 
computer, Raspberry Pi keeps the files you're 
working on in volatile memory - memory which 
is emptied when the system is switched off. For 
documents you're creating, it's enough to save 
each in turn - which moves the file from volatile 
memory to non-volatile memory (the microSD 
card) - to ensure you don't lose anything. 

The documents you're working on aren't the 
only files open, though. Raspberry Pi OS itself 
keeps a number of files open while it's running, 
and pulling the power cable from your Raspberry 
Pi while these are still open can result in the 
operating system becoming corrupt and needing to 
be reinstalled. 

To prevent this from happening, you need to 
make sure you tell Raspberry Pi OS to save all its 
files and prepare to be powered off - a process 
known as shutting down the operating system. 

Click on the Raspberry Pi icon at the top left 
of the desktop and then click on Shutdown. A 
window will appear with three options (Figure 
23): Shutdown, Reboot, and Logout. Shutdown is 
the option you'll use most: clicking on this will 
tell Raspberry Pi OS to close all open software and 
files, then shut the Raspberry Pi down. Once the 
display has gone black, wait a few seconds until the 
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flashing green light on your Raspberry Pi goes off, 
after which it's safe to turn off the power supply. 

If you press the button once, you'll see the same 
window appear as if you'd clicked the Raspberry 
Pi icon followed by Shutdown; press the power 
button again when the window is visible and 
Raspberry Pi will shut down safely. 

If you press and hold the power button for 
longer, it will perform a hard shutdown - 
effectively the same as if you'd just turned the 
power off. Only do this if your Raspberry Pi isn't 
responding to your instructions and you can't 
shut down any other way, as it runs the risk of 
corrupting your files or operating system. 

To turn Raspberry Pi back on disconnect then 
reconnect the power cable, or toggle the power at 
the wall socket. 

Reboot goes through a similar process to 
Shutdown, closing everything down, but instead 
of turning Raspberry Pi's power off, it restarts 
Raspberry Pi - as if you'd chosen Shutdown, then 
disconnected and reconnected the power cable. 
You'll need to use Reboot if you make certain 
changes which require a restart of the operating 
system — such as installing certain updates to 
its core software — or if some software has gone 
wrong, known as crashing, and left Raspberry Pi 
OS in an unusable state. 

Logout is useful if you have more than one 
user account on your Raspberry Pi: it closes any 
programs you currently have open and takes you 
to a login screen on which you are prompted for 
a username and password. If you hit Logout by 
mistake and want to get back in, simply type the 
username and whatever password you chose in the 
Welcome Wizard at the start of this feature. 
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Learn Python: 
explore functions 
and build a CLI app 


Let's get functional with Python. In this tutorial, you'll learn how to define and 
call functions to save yourself writing the same code over and over again 


They help you break down Python programs 
into small, manageable parts that can be 
easily repeated. They make your code more 
modular, and easier to understand. 
Some people like to think of functions like 
cutting and pasting. You write the code once 
(known as ‘defining’) and then paste the code 
(called ‘calling’). While this is helpful to start with 
functions are more powerful than cut-and-paste 
because they accept input and provide output. 
In this tutorial, we’ll look at defining and calling 
functions with different arguments. Then we 
will use this to create an advanced version of the 
ToDo program from last issue that saves our list 
to a file, and can be run from anywhere in the CLI 
(Command Line Interface). 


E unctions are the beating heart of Python. 


2 Functions are the beating 
heart of Python Ei 


Functions are defined using the def command, 
followed by the name of the function and parentheses 
(which contain optional parameters are passed into 
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the function). An optional return command sends 
any results back from the function to your main 
program. It looks like this dummy code: 


def function(optional parameter): 
# code to do things 
return optional return value 


The code underneath a function is indented 
by four spaces. This lets Python know that the 
indented code is run when the function is used 
(known as a “function call"). 

Let's create a function for real. Open the 
Thonny IDE and create a new file (save it as 
add numbers.py. Now enter this code: 


# Define a function that takes two numbers as 
arguments and returns their sum 
def add питбегѕ (пит1, num2): 

total = num1 + num2 

return total 


# Call the function with 2 and 3 as arguments 
result = add_numbers(2, 3) 
print(f"The sum is: (result)") 
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todo.py X 


import sys 
import os 


home dir = os.path.expanduser('-') 
todo file = os.path.join(home dir, 'todo list.txt') 


def load tasks(): 


if os.path.exists(todo file): 
with open(todo file, 'r') as file: 
tasks = file.readlines() 
tasks = [task.strip() for task in tasks] 
else: 
AU 


return tasks 

def save tasks(tasks): 
with open(todo file, 'w') as file: 

for task in tasks: 

file.write(f"(task) Wn") 
def add task(task): 
tasks - load tas 
tasks append(task) 
save tasks(tasks) 


def view tasks(): 


ToDo List: 
1. Buy Coffee! 


>>> 


The Shell in Thonny is used here 
to run the program and view the 
items on our ToDo list 


The function of this program is to take two 
numbers and add them together. Pretty simple. 
The program comes in two parts. The first part is 
the def that defines the function: 


def add_numbers(num1, num2) 


The second part is the function call, which asks 
the add_numbers function to add the numbers 2 and 
3 together and store the returned total variable in 
another variable called result. 


result = add_numbers(2, 3) 


Finally, we print out the answer using print(). 
Click Run in Thonny and you should see: “The 
sum is: 5” in the Shell window below. 


REPL to sender 

One of the joys of Python is that you can interact 
with programs in the Shell while running them 
thanks to REPL (Read-Eval-Print Loop). Click in 
the Shell and call the function directly with any 
values you want. 


add_numbers(6, 2) 
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This returns 8 in the Shell. While we’re in REPL 
we should chat about “scope” or “function scope” 
in this particular concept. In REPL you can access 
and look at the variables of your program directly. 
Enter result and Shell displays “5” (the value 
stored by the program on line 7 during the function 
call when it returns the total value). 

Enter total, however, and Shell returns: 


* Our introduction to 
functions takes two 
numbers and adds 
them together 


Traceback (most recent call last): 
File “<pyshell>”, line 1, in <module> 
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NameError: name ‘total’ is not defined 


Why can we access the result variable, but not 
the total variable? The answer is that variables 
inside function definitions (the part indented 
under def) are "local". That means they can only 
be accessed locally inside that function. 

Once you get back out of the function and 
into your program the local variables (like our 
total) are no longer needed, and in a modern 
programming environment like Python the 
memory space they cleaned and reused. 

This is why it is important to use return and 
store any variables or output from your function 
that you want to use in the rest of your code. 


Default variables 
Let's raise another problem in Shell: the add_ 
numbers () function call without any arguments: 


add numbers() 
Shell returns another error message: 


TypeError: add numbers() missing 2 required 
positional arguments: ‘num1’? and “пит2? 


Reading the error message tells us what's 
going wrong. Our “missing 2 required positional 
arguments" (the two numbers). 

We can fix this by adding two numbers to the 
function call. But it is also possible to add default 
parameters to a function definition. 

Say we are creating a program that addresses 
people by name, but allows them to remain 
anonymous. Our function could say “hello” when 
they enter their name 


о° ө 
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def say hello(name): 
print(f"Hello, {name}”) 


We could call this function using : 
say һе110(“А1ісе”) 


But if we want to include the anonymous default 
we add it to the parameters using name=”anon”. 
Enter the code from say. hello.py. 


def say hello(name-"anon"): 
print(f"Hello, {name}!”) 


# Calling the function with a specific name 
say һе110(“А1ісе”) 


# Calling the function without specifying a 
name, which uses the default value “anon” 
say hello() 


Run this and you will see: 


Hello, Alice! 
Hello, anon! 


Getting into arguments 

One of the limitations of the functions we've 
created so far is that they only work with a 
specific number of arguments. Our ааа numbers. 
py program only adds two numbers together, 

for example. 

What if want to manage multiple arguments of 
different amounts? In this case you need to know 
about the *args parameter. 

This is a special type of parameter which 
handles multiple arguments. The “*” tells Python 
to pack these into a special type of list called a 
“tuple”. Create and Run the following program, 
calling it add mult numbers.py. 


def add numbers(*args): 
total - 0 
for number in args: 
total += number 
return total 


print(add_numbers(1, 2, 3)) #6 
print(add_numbers(1, 2, 3, 4, 5)) # 15 


Run it and Shell returns 6 and 15. There is also 
a second special parameter called **kvargs which 


handles multiple key/value pairs (which we're not 
going to go into here as key/value pairs would 

be a distracting subject). There are two values to 
unpack hence the two asterisks. 


Recursion 

Take a deep breath, as this one is likely to hurt 
your head. Recursion is a relatively hairy concept in 
programming that quickly causes a headache if you 
think too hard. 

The general concept is that a function definition 
contains a call to itself. When the function is 
called, it - in turn - calls another version of itself 
with a modified argument. 

A simple recursive function is this one, that 
calculates the sum of all numbers up to a given 
number. For instance, to find the sum of all 
numbers up to 4, you'd calculate 4 + 3 + 2 +1, 
which equals 10. 


def sum up to(n): 
# Base case: if n is Ө, the sum up to 0 
is just Ө 
ifn ee 
return @ 
# Recursive case: n plus the sum of 
numbers up to n-1 
else: 
return n + sum up to(n-1) 


# Example usage 
print(sum up to(4)) # Output: 10 


This function works by taking the integer we 
supply (as ‘n’) and adding to it all the numbers 
that are 1 below it. It does this by adding n to the 
sum of n-1 (by calling sum up. to(n-1) for all the 
numbers until it hits О. 

Then it works back up the chain to output the 
final sum. Recursion is one of those magical parts 
of Python that you will encounter fairly frequently, 
and it works but it can be quite challenging to 
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What's a tuple 


Atuple is a special 
type of data 
structure that is 
similar to a list, only 
it is immutable (fixed 
and unchangeable). 
Once created it can't 
be changed, only 
used or deleted. 


* This function takes 
multiple arguments 
using the ‘args parameter 
| instead of specifying 
individual parameters 


Local Python 3 © /use/bivpythons = 


visualise in your mind. Please don't worry if you 
don't quite get it from this simple introduction. 
There will be time to understand recursion later. 


Command line 

Let's turn what we've learnt about Functions into 
a useful program. We're going to expand on the 
ToDo list from the previous exercise. This time 
we're going to turn it into a more detailed program 
that runs from the command line. 

Enter the code from todo.py in Thonny and 
save it to your disk. Open a Terminal window, 
navigate to the same directory as your todo.py 
program, and run the program to add, view, and 
delete tasks. 


* To add a task, use: python todo.py add “Task 

details here" 

* To view all tasks, use: python todo.py view 

: To delete a task by its number (as shown in the 
view), use: python todo.py delete 1 (where 1 


is the task number to delete) 


This application demonstrates basic file 
handling, argument parsing, and simple CRUD 
(Create, Read, Update, Delete) operations in a 


'* Running our todo.py 
Python program from 
the Terminal 


$ рда Bloom JEF 


mm 
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m We removed the .py extension when 


moving the file, This is so we can run the 


command from anywhere in Terminal Ej 


TopTip è 


Run from 
Thonny 


You can run todo. 
py from Thonny with 
arguments using the 
%Run command in 
Shell, for example, 
%Run todo.py view. 


Y Our final ToDo 
program running 
directly asa 
command anywhere 
in Terminal 
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command line application using Python. Feel free 
to extend it with more features, like editing tasks 
or categorising them. 


Let's script it 

To turn todo.py into a fully-fledged application (or 
script) that you can run from the command line, 
follow these steps. 

Add a “shebang” line (#!) to the start of the 
program. This tells the command line which 
version of Python to use. Make sure this is the 
very first line. 


#!/usr/bin/env python3 


Now make the script executable. Open a 
terminal window in the same directory as your 
todo_list.py file and enter the following: 


cd /path/to/todo.py 
chmod +x ./todo.py 


Replace the /path/to/todo.py with your own 
directory. In our case: /home/lucy/Documents/ 
todo.py. 

The chmod +x command adds executable rights 
to the file, allowing the code to be run from the 
command line. 


Now copy the file from your working directory 
to a directory on your PATH. The path is a list 
of locations that terminal checks for files when 
you run commands in the shell. You can see the 
current PATH locations with: 


echo $PATH 


The directories in the PATH are listed with a colon 
“27 separating them. A common place to move files 
to is /usr/local/bin (bin stands for “binary”). We're 
going to copy our todo.py file here (you will need 
to use sudo to gain permission): 


sudo cp ./todo.py /usr/local/bin/todo 


Notice that we removed the .py extension 
when moving the file. This is so we can just run 
the command from anywhere in Terminal using 
*todo" as we would any other command like 15, 
Cp, or cat. Now either close Terminal and open 
another window, or enter the following command 
to refresh the shell. 


source ~/.bashrc 


Now you can run the program from anywhere in 
Terminal using just the command todo followed by 
an option: 


* todo add 
* todo view 
* todo delete 


Congratulations now you have a working ToDo 
program that saves your ToDo list to a file called 
todo list.txt in your home directory. You can view 
ToDo's using the todo view option or using cat ./ 
todo list.txt. 

There's plenty more you can do with your 
ToDo program. Above all we hope you've enjoyed 
learning about Functions and building a fully 
functional program that adds to your Raspberry Pi 
Terminal. M 
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todo.py 


DOWNLOAD 
THE FULL CODE: 


» Language: Python 


e magpi.cc/github 


001. 
002. 
003. 


004. 


005. 
006. 
007. 


008. 


009. 
010. 
011. 
012. 
013. 
014. 
015. 


016. 
017. 


018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
өзе. 
031. 
032. 
033. 
034. 
035. 
036. 
037. 


#!/usr/bin/env python3 


import sys # Import the sys module to access 
command-line arguments 

import os # Import the os module to check if a 
file exists 


# Define the path to the file 

home dir = os.path.expanduser('~') # Gets the 
user's home directory 

todo file = os.path.join(home_dir, 
"todo_list.txt') # Builds the full path 


def load tasks(): 
# Load tasks from the file 
if os.path.exists(todo file): 
with open(todo file, 'r') as file: 
tasks = file.readlines() 
tasks = [task.strip() for task in 
tasks] # Remove newline characters 
else: 
tasks = [] # Return an empty list if 
the file does not exist 
return tasks 


def save_tasks(tasks): 
#Save tasks to the file 
with open(todo file, ‘w') as file: 
for task in tasks: 
file.write(f"{task}\n") 


def add_task(task): 
# Add a new task 
tasks = load_tasks() 
tasks.append(task) 
save_tasks(tasks) 


def view_tasks(): 
# Display all tasks 
tasks = load_tasks() 
if tasks: 
print("ToDo List:") 
for idx, task in enumerate(tasks, 


038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 
050. 
051. 
052. 
053. 
054. 


055. 


056. 
057. 
058. 
059. 
060. 
061. 
062. 
063. 
064. 
065. 
066. 
067. 
068. 
069. 
070. 


071. 
072. 


073. 
074. 
075. 


start-1): 
print(f'(idxj. (task) ") 
else: 
print("Your ToDo list is empty!") 


def delete task(task number): 
# Delete a task by its number 
tasks - load tasks() 
if 0 « task number «- len(tasks): 
del tasks[task number - 1] 
save tasks(tasks) 
print("Task deleted successfully.") 
else: 
print("Invalid task number.") 


def main(): 
# Check if the user has provided a command 
if len(sys.argv) « 2: # The first argument 
is the script name 
print("Usage: python todo.py [add/view/ 
delete] [task]") 
return 


command = sys.argv[1].lower() 

if command == ‘add’: 
task = ' '.join(sys.argv[2:]) 
add_task(task) 
print("Task added.") 


elif command == 'view': 
view_tasks() 
elif command == ‘delete’: 


if len(sys.argv) == 3: 
task_number = int(sys.argv[2]) 
delete_task(task_number) 
else: 
print("Usage: python todo.py delete 
[task number]") 
else: 
print("Invalid command. Use add, view, 
or delete.") 


if name " main ": 


main() 
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CDP Studio: 
Control a robot arm 


Use CDP Studio and its Kinematics framework 
to control а Raspberry Pi-based robot arm 


DP Studio is an ‘out of the box’ 
C software development tool used by 

many companies to build industrial 
control, automation, and edge systems. Yet 
it’s fairly easy to get to grips with its low-code 
programming environment. 
In The MagPi issues 116 and 117, we showed you 
Phil how to deploy a couple of projects to a Raspberry 
King Pi. This time, we'll be using CDP Studio and its 
Kinematics framework to program a Raspberry 
Pi-powered robot arm, the myCobot 280 Pi that 
we reviewed in issue 137 (magpi.cc/137), to 
perform a pick and place routine. If you don't have 
the robot arm, you can still run the project and 
record movement steps to see how they affect the 
position of a virtual arm shown on screen. 


Long-time contributor 
to The MagPi, Phil is a 
freelance writer and 
editor with a focus 
on technology. 


@philkingeditor 


Install the software 

On your PC, visit cdpstudio.com/getstarted 
and download the free non-commercial version 
for Windows or Linux. During installation, select 
the ‘ARMv8 64-bit (Debian 11)’ component under 


т Adding the ARMv8 
64-bit (Debian 11) 
toolkit required 
to control the 


myCobot robot arm 
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CDP Studio 4.12, along with the one already ticked 
for your host PC. You will then be able to deploy 
projects to the myCobot 280 Pi arm, which uses a 
64-bit version of Ubuntu. 

If you already have CDP Studio installed, 
make sure it's updated to version 4.12, then go 
to Help » Package Manager and select 'Add or 
remove CDP versions! to add the ARMv8 64-bit 
(Debian 11) component. 


Download the project 

This is a complex project that would 
be time-consuming to build from scratch, so 
we'll download it from СОР Studio’s GitHub 
repo. Go to magpi.cc/recordnplay, click the 
green Code button, and select Download ZIP. 
Unzip the file on your PC. Move the resulting 
myCobotRecordNPlay - main folder to the 
CDPStudioWorkspace/systems folder. 


Download and build library 

To deploy the project to the robot arm, 
you’ll also need the myCobotLib library. Go to the 
GitHub repo at magpi.cc/mycobotlib, click the 
Code button and Download ZIP. Extract it and then 
move the resulting myCobotLib- main folder to 
the CDPStudioWorkspace/libraries folder. Open 
the myCobotLib project file (with the .pro suffix) 
in CDPStudio, then right-click its name in the left 
panel and select Build. 


Open the project 
Now open the RecordNPlay CDP project 
file (.pro) in CDP Studio. If you click the arrow 


The myCobot 280 Pi robot arm 
can be programmed to perform 
а series of movements 


next to it in the left panel, you'll note that it 
comprises two main applications. RecordNPlayUI 
runs the database logic for recording arm 
movement steps and shows a GUI on the PC to 
make programming the arm easier. It also has an 
ArmVisualizer pane that can be used to view the 
arm positions in 3D. This can be used even if you 
don't have a real arm connected, so you can still 
run the project and see how recorded steps affect 
its movements. 

The RecordNPlayIO application is the part of the 
project that's deployed to the myCobot Pi arm over 
the network, once paired, enabling CDP Studio to 
communicate with it. 


Prepare myCobot 

The myCobot arm's Ubuntu OS has a 
non-standard version of the OpenSSH server. So 
you'll need to make a small change to a config file 


so CDP Studio can communicate with it over the 
network. SSH into the myCobot with the username 
‘er’ at its IP address; the default password is 
‘Elephant’. Then enter: 


sudo nano /etc/ssh/sshd config 


Locate the line that sets the PubkeyAuthentication 
parameter and set it to yes (and make sure the line 
is not commented out). Press CTRL+X, then Y to exit 
and save. Then restart the OpenSSH server with: 


sudo systemctl restart sshd 


Pair the arm 

Open the Deploy Configuration tab. Under 
Networks, press the Select button for ‘WiFi’. The 
‘Devices - WiFi’ table below should start showing 
any devices available to pair with CDP Studio. 


CDP Studio: Control a robot arm 


Марі 


Various attachments 
enable the arm to 
perform different tasks 


You'll Need 


> Windows or Linux PC 


CDP Studio 4.12 
cdpstudio.com/ 
getstarted 


» myCobot 280 Pi 
robot arm 
magpi.cc/ 
mycobot280 


» myCobot Adaptive 
Gripper 
magpi.cc/ 
mycobotgripper 
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Device и 192.162.174 


Device at 192 160.198 
Device t 1921681112 
Device at 1921621219 


€: 
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puro 
acer X 


Good Bye: 
12:27:57: C1\COPStudioWorkspace\deploynents\systems\COP_4.12_ Windows_186_64-bit\RecordNPlay\RecordNPLayUT\RecorduPlayUT.exe exited with code 9 


WE Р Type here to search 


robot arm with CDP 
Studio over the 
Wi-Fi network 


А Pairing the myCobot 


TopTip ё 


Another arm 


While this project 
is designed for 
the myCobot 280 
Pi, you could use 
a different robot 
arm - you'd just 
need to create 

a new IO library 
to communicate 
with it. 
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Click the Username field for your myCobot 
(based on its IP address) and enter ‘er’, then click 
the Pair button next to it. You will be prompted to 
enter the password - the default is ‘Elephant’. 

Under Applications, change the Device for 
RecordNPlayIO application to your myCobot device 
name, then change the Toolkit to ARMv8 64- 
bit (Debian 11). When you run the RecordNPlay 
project, this will then be deployed over the 
network to the robot arm. 


07 Run the project 

Right-click RecordNPlay in the left panel 
and select Run & Connect. After a few moments, 
a new Arm Record'n'Play window should appear, 
showing the GUI for recording arm movements. 
First, enter a name for the sequence and click Add. 
Then click Record to start recording steps. You 


can move the sliders, but it's a lot easier to move 
the robot arm around and then click its LED panel 
button to add each position as a step. Recorded 
steps are shown in a list and can be updated or 
deleted individually using the buttons at the 
bottom right. The 'Step duration' bar sets the 
time for which an arm position is held. 

Try recording some steps and then hit the 
top-left Play button to play the sequence. If 
you have a myCobot arm connected, it should 
follow the movements you recorded; if not, select 
ArmVisualizer in the project's left panel, then the 
DHChain Visualizer tab to view a 3D representation 
of the arm with its six joints. As you move 
between two steps, the visualisation shows both 
and the movement of the arm's head with a red 
line. The gripper status is indicated by a green 
(closed) or grey (open) dot. 


Pick and place 

Now, let's get our arm to pick up an object 
and place it down in another location. We placed 
a pencil sharpener on top of a biscuit tin, high 
enough to give the arm plenty of space to pick it up 
without the bottom of the gripper hitting the table. 


m We placed a sharpener оп 
top of a biscuit tin Ø 
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Move the arm between positions and press the 
LED panel button to record each step. You can 
also open and then close the gripper manually to 
program it. Make sure the arm is stationary, in the 
right position, before closing it. Then lift the arm up 
and move it round and down to where you want to 
place the object. After opening the gripper to drop 
it, move the arm straight up so you don’t bump into 
the item. You can adjust step positions in the GUI if 
needed. The steps are stored in an SQLite database 
too, so you could always edit that manually. 


SEQUENCE STEPS LIST 


JeiiAngie — JeitlAngl  Joim3Angie Јолда Joint SAngle  JointóAngie ^ GripperOos 


STEP (END STATE) 
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Kinematics 

This project makes used of CDP Studio's 
Kinematics framework, in the form of the DHChain 
component. The basic concept of kinematics is 
that if you input joint angles for a robot arm, or 
chain of links, the framework can calculate the end 
position in 3D space - as shown in our project's 
ArmVisualizer pane, with the X/Y/Z coordinates 
shown in the Arm Record'n'Play GUI. 

The method can also be used in the reverse 
direction, to convert a desired 3D end position 
into the required joint angles; this is known as 
‘inverse kinematics’. 

Kinematics has many uses in the field of 
engineering, helping to calculate positions and 
velocities of moving parts such as those in 
an industrial robotic arm, or a bionic limb or 
exoskeleton. An example real-world case is the 
use of CDP Studio and kinematics is for controlling 
deck cranes on ships. 


Exploring the project 

You can click the Block Diagram tab to 
see how the project's block-based components 
have been put together. At the highest level, 
there are two main blocks: for the RecordNPlayUI 


9 As you play a sequence, 
you can see the effects 
on a virtual arm in the 
ArmVisualizer pane 


Actustorx (ит 


Actuator y soa 


ActustorZ 34 


Y The myCobot's adaptive 
gripper attachment can 
be used to pick up and 
drop objects 


Step duration — 


application for the GUI step recorder, and the 
RecordNPlayIO one for communicating with the 
myCobot arm. Here, the UI block’s DesiredStates 
port links to the IO block's DesiredAngles port; 

it sends the angles set for the six joints, along 
with the gripper status, so that the arm will move 


accordingly. The ControlModes link is used to 
determine whether the arm should maintain a 
position or be allowed to move freely, for when 
you're recording moves. CurrentStates is a 
feedback port from IO that's used by UI to know 
what is the current position of the arm joints, 
gripper and LED button; this information is used 
by the recording process in UI. M] 
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Sturdy base 


You'll need a base 
for your robot arm, 
to stop it falling 
over as it moves. 
We used the 
G-Base 2.0 to clamp 
ours to a table. 


Y There are two main 
application blocks, 
the UI step recorder 
running on the 
PC, and the IO for 
communication 
with the arm 
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The USB connection 
on the right is for 
the camera on the 


How the Robot Operating System helps you build complex robots robot arm 


etting into robot development has 

never been easier or cheaper. You 

can pick up a robot kit for not much 

more than the price of a video game. 

If you spend a little more money, you 

can get one with a robot arm on top, 
like the one shown in Figure 1 above. Many of the 
robots use mecanum wheels, which allow the robot 
to move in any direction. 

Figure 2 shows what is controlling the robot. A 
Raspberry Pi sits underneath a 'HAT' which manages 
the power supply (two 18650 lithium batteries) 
and the signals to control the motors and the robot 
arm. The robot runs a set of Python programs 
which control the hardware and allow it to perform 
preprogrammed tasks. 


Rob Miles 
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Figure 3 shows the remote-control application 

you can use to tell the robot what to do. The robot 
hosts a Wi-Fi access point to which you connect the 
mobile application. You can then select from pre-built 
behaviours. This works well, but what if you wan 
to do more? The author was very keen to use his 
robot as a platform for learning the Robot Operating 
System (ROS). So that is what he has decided to do. 
The robot is presently driven by Python programs; 
the idea is to turn these into ROS nodes. But first, 
we must learn a bit about ROS itself. 


COMING UP ROS-ES 
An operating system is something you add to 
hardware to make it useful. Examples are Windows, 
MacOS, or Linux. The operating system takes the 
raw ability of the hardware (running programs, 
reading keyboards, saving data, displaying images 
оп screens, etc.) and provides a user interface. 
The operating system lets you select the program 
you want to run. When you start the program, the 
operating system fetches the selected program from 
mass storage and then performs the instructions in 
the program. Some of the instructions will ask the 
operating system to do things; for example, a word 
processor will ask for a document file to be loaded 
into memory. 

ROS takes the abilities of a computer system 
and makes it useful to a robot creator. ROS lets you 
break a system down into cooperating components. 
Components are created inside packages, which 
makes it easy to manage complex solutions. 
There are many pre-built components that you can 
incorporate into your solutions. ROS also provides 
tools you can use to express the physical design of 
your robot (or other mechanical system controlled 
by ROS elements) and simulate behaviour in a virtual 
(i.e. computer-generated) environment. ROS is a 
rich and complex system which can take a while 
to master. It provides effective solutions to robotic 
problems that we aren't even aware we have. 
Learning it will hurt your head a bit, but it is worth 
the effort. 


INSTALLATION 

ROS sits on top of the computer operating system 
and is closely coupled to it. This means that the 
versions of ROS you can use are determined by the 
operating system on your computer. You can run 
ROS directly on a Windows PC, but the installation 
is not for the faint-hearted as it involves compiling 
the ROS program source. It is much easier to use 

a Linux-based machine for which you can obtain 
compiled binary versions of ROS. On a Windows 
PC, you can use the Windows Subsystem for Linux 


Robot Control 
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(WSL) to make a Linux environment into which you 
can install ROS. There is a step-by-step guide to the 
installation process in the GitHub repository for this 
article (hsmag.cc/Roslntro). The process uses the 
amazing Docker tool, which makes it possible to 
host any version of Linux on your machine, whatever 
its architecture or operating system. 

ROS is a large application that needs plenty of 
memory to run. It will not fit on smaller devices as 
it needs at least AGB of RAM. If you are using a 
Raspberry Pi, you can add a swap file to your system 
which uses file space to extend main memory. 
However, if you do this, you may find that your SD 
card (the place where your files are stored) wears 
out as the operating system will continually write to 
the swap file as programs are started and stopped. 
If you are feeling brave (and have a few spare SD 
cards), there are instructions on how to do this in the 
installation guide. 


INSIDE THE WORLD OF ROS 

ROS breaks a robot application down into nodes. 

A node is implemented as a running program. The 
nodes talk to each other in a well-defined way, and 
they cooperate to keep the robot running. The nodes 
can all run as individual tasks on a single computer, 
or they can run on lots of different processors 
connected to the local network. 

Figure 4, overleaf, shows a ROS installation 
which contains a controller, a robot, and a camera. 
Perhaps we want to make a robot litter picker which 
will wander around searching for litter. The robot is 
constructed as three devices: a controller, a robot 
rover, and a camera. Each device is running one or 
more nodes that form part of the ROS solution. 

Nodes provide services to other nodes and accept 
commands from them. In addition, any node can 
publish data items that any other node can subscribe 
to. There are lots of advantages to organising a 
robot application this way. It is easy to move nodes 
between devices. The connections between the > 
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Figure 3 4 

This application 

is running on an 
iPhone. A version 

of the code is also 
available for Android 


YOU'LL NEED 


Ф А reasonably 


powerful desktop 
computer, laptop, 
or Raspberry Pi 
(preferably a 4 

or 5 with 4GB 

of RAM) to run 
the development 
environment 

and ROS 


Your own little 
robot or the parts 
to make one 


QUICK TIP 


You can use 

your knowledge 
of ROS to power 

a pre-built robot 
or to take control 
of a robot that 
you have created 
yourself out of 
components you 
have chosen. 
There are tips on 
hardware choices 
in the GitHub 
repository for this 
article: hsmag.cc/ 
Rosintro 
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QUICK TIP 


ROS is not just good 
for robots. If you've 


got a complex 


application that you 
want to break down 


into cooperating 
components, you 


should look at what 


ROS offers. 


{МАКЕ BUILD P 


HackSpace 


This tutorial is from 
HackSpace magazine. 
Each issue includes a 
huge variety of maker 
projects inside and 
outside of the sphere 
of Raspberry Pi, and 
also has amazing 
tutorials. Find out 
more at hsmag.cc 


ACK CREATE 


nodes are well-defined. We could move all the nodes 
onto a single powerful computer, or replace the 
vision system with one that uses a different camera. 
We don't have to write the code for all the nodes. 
ROS also includes a library mechanism that makes 
it easy to import node code. To properly understand 
all of ROS, you must understand all the problems 
that it solves, and there are many of those. Let's 
start with something simple. How do ROS nodes 
help us get our ‘litter picker’ robot going? 


CLEANING UP 

To activate the litter-picking robot, the user could 
press the 'Search' button on the controller device. 
The buttons on the front panel of the controller are 
managed by the buttons node, which publishes the 
button states on a topic called 'buttons'. 

The manager node has subscribed to this topic, so 
it receives a message informing it that the Search 
button has been pressed. The manager then sends 
a service request to the vision node asking, "Can 
you see anything?" 

The vision system has subscribed to frames 
of image data published by the camera node and 
is looking for litter in each frame it receives. If the 
manager gets a response indicating that some litter 
has been spotted and giving a direction to that 
litter, the manager sends commands to the motor 
node in the robot to head that way. The manager 
also publishes the message 'moving' to a robot 
status topic. 


Controller 


movement 


vision 


manager 


Camera 


image source 


display 


buttons 


Figure 4 4 
There are eight nodes in this system 


The display node has subscribed to this topic, 
so the status 'moving' is displayed. As the robot 
moves, the sensors node on the robot would be 
publishing information about things the robot is 
detecting around it. ROS provides the environment 
in which all this would be made to work. We design 
the structure of the published data, write the code 
for each node, and then decide how the nodes 
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will interact, but ROS sits underneath and makes 
everything work. 


PUSH THE BUTTON 
We can discover how ROS does this by considering 
the very start of this process: the front panel of 
the robot. At the very least, the robot will have a 
button to make it start and a button to make it stop. 
It should also have a way of indicating what it is 
doing, perhaps a coloured light or a text display. 
The diagram in Figure 4 shows that the Controller 
is running а buttons node which receives user 
commands and a display node that displays the 
robot status. 

Let's look at the code in this node, which 
is implemented by a Python class called 
ButtonPublisher. This class extends the Node class 
which is part of ROS. An instance of ButtonPublisher 
class is created when the robot system starts up. 
Below, you can see the constructor method which 
runs when a ButtonPublisher is created. 


class ButtonPublisher(Node): 


def . init | (self): 
super().. init. ('button publisher') 
self.buttonReader - ButtonReader() 
self.start publisher() 
self.start timer() 


The constructor first calls the __init__ method 
for the Node parent class, supplying the call with the 
name of the publisher. This tells ROS that there is 
a new node called button, publisher in town. The 
next statement in __init__ creates a ButtonReader 
object which will be used to read the buttons on the 
physical console. 

The ButtonReader reads the buttons from the 
controller hardware, perhaps by using GPIO pins 
(although it could also connect to a computer 
keyboard or touchscreen). Next, the constructor 
calls start. publisher to create a publisher to publish 
button events to anyone who is subscribed to them. 
Then it calls the start. timer method to start the 
button scanning timer. There is not much code in the 
start publisher method: 


def start publisher(self): 
self .publisher_ = self.create. 
publisher(String, 'buttons', 10) 


The publisher to be used by ButtonPublisher 
is stored in a class member called publisher. 
The create. publisher method is inherited by 


ButtonPublisher from its Node parent class. The 
publisher method accepts three parameters. The first 
indicates that the publisher will publish a String, the 
second gives the topic for the published message 

(in this case, ‘buttons’), and the third parameter (the 
value 10) means 'keep the last ten published items 
and use the “RELIABLE” level of quality of service’ — 
which means that published items are guaranteed to 
arrive at the receiver. The second method called by 
the ButtonPublisher constructor is start, timer 


def start timer(self): 
timer period = 0.1 # seconds 
self.timer = self.create timer(timer, period, 


self.timer callback) 


This method creates a timer which fires ten times 
a second. Each time the timer fires, the timer. 
callback method is called. 


def timer callback(self): 


button = self.buttonReader.scan buttons() 
if button!="": 
msg = String() 
msg.data - button 
self .publisher_.publish(msg) 
self .get_logger().info('Publishing: "%s"' 
% msg.data) 


The timer_callback method calls the method 
scan_buttons on the button reader. This scans the 
buttons and returns the name of the button which 
is pressed, or an empty string if no buttons are 
pressed. If a non-empty string is returned, the 
callback publishes the name of the button that is 
pressed on the ‘buttons’ topic. 

The final part of the button node program is the 
mechanism which starts the node itself. This is 
performed by the main method in the node code 
which is called when the node is loaded. 


def main(args=None): 
rclpy.init(args-args) 


button publisher - ButtonPublisher() 
rclpy.spin(button, publisher) 

# Destroy the node explicitly 
button publisher.destroy. node() 


rclpy.shutdown() 


The main method creates a ButtonPublisher 
instance and then calls the button publisher method 
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on this. The rclpy.spin function keeps the node 
alive; responding to events and managing callbacks. 
It ends if the node is terminated by ROS, at which 
point the publisher node is destroyed and the node 
shuts down. 

All the nodes in the robot are started in this way. 
The robot controller code can contain a launch 
method which starts all the nodes when the robot 
begins running. 


SUBSCRIPTION MODEL 

We know how a node running in a robot can post a 
message on a topic. Next, we need to consider how 
another node can receive it. 


class DisplaySubscriber(Node): 


def | init. (self): 
super().. init. ('display. subscriber') 
self.subscription = self.create_ 
subscription( 
String, 
'buttons', 
self.listener callback, 
10) 
self.subscription # prevent unused 
variable warning 


def listener  callback(self, msg): 
self.get logger().info('Button: "Xs" was 
pressed' % msg.data) 


The code above defines a DisplaySubscriber 
class which subscribes to the buttons topic and 
calls the listener callback function each time a 
message is received. This listener callback simply 
logs the button name (although it could put it on a 
text display). Code in the manager node could also 
subscribe to the buttons topic so that the manager is 
informed when a button is pressed. 


QUICK TIP 


The most recent 
version of ROS is 
called ROS2. 

This is the one you 
should be using. 


PACKAGE HOLIDAY 

Code for ROS applications is organised into 
packages. A package brings together a set of related 
behaviours. We could create a package called front_ 
panel which contains the code for the buttons and 
display nodes. 

Figure 5, overleaf, shows the package files for 
the front. panel package. The two highlighted files 
contain the code for the buttons and display Python 
nodes that we have seen above. The three files 
at the bottom of the package are what ties the 
package together. The package.xml file contains 
a description of the package and identifies any 
dependencies that the package has. > 
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Figure 5 © 

ROS can generate 
a template package 
for you to fill in 


One package can use elements from another, 
and this is where you would identify the source 
packages. The setup.cfg file specifies where the 
files are to be placed, and the setup.py is a chunk of 
Python which is run to set up the project. This file is 
worth looking at: 


from setuptools import find packages, setup 
package name = 'front, panel' 


setup( 
name-package. name, 
version-'0.0.0', 
packages=find_packages(exclude=['test']), 
data_files=[ 
('share/ament_index/resource_index/ 
packages', 
['resource/' + package_name]), 
('ѕһаге/' + package. name, ['package. 
хт1'1), 
15 
install requires-['setuptools'], 
zip.safe-True, 
Maintainer='rob', 
maintainer, email-'robehullpixelbot.com', 
description-'Provides a front panel containing 
buttons and a text display', 
license-'Apache-2.0', 
tests, require-['pytest' ], 
entry. points-( 
'console scripts': [ 
"buttons = front, panel.buttons, member . 
function:main', 
‘display = front, panel.display. member . 
function:main' 
1, 
>, 


Above is the setup.py file for the front. panel 
package. The most important part of this file is the 
entry point list at the bottom. It specifies the Python 
files that are to be run when the nodes are activated. 
If we added a third node to the panel (perhaps a 
buzzer controller), we would create the Python code 
for the node and then add the entry point here. The 
above package serves as a template for any future 
packages you want to create. Just add the Python 
code into the same folder as the existing nodes and 
configure setup.py with the new entry points. Your 
code can then be run as a node in the robot system. 
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v front panel 

Ф init .py 

Ф buttons member function.py. 
® display member function.py 
Y resource 

front panel 

м test 

Ф test copyright.py 

Ф test flake8.py 

® test pep257.py 

Й LICENSE 

A package.xml 
1$ setup.cfg 

Ф setup.py 


BUILDING THE PACKAGE 

Now that we have our package, the next thing 

we need to do is build it. This is the process of 
collecting all the package components and getting 
them into a state where ROS can run them. Python 
programs are not compiled, but ROS nodes can also 
be created from С++ code, which does need to be 
compiled before it can run. A package that contains 
С++ code has a slightly different format and contains 
a CMakelists.txt file which describes how to build 
the code. It makes creating a package a bit trickier, 
but it does mean that you can use both languages 
in your solution. Furthermore, you can import 
packages containing nodes programmed in С++ 
and they will work alongside your Python nodes. 
The ROS system provides a command called 

colcon (collect components) that performs the 

build process: 


colcon build --packages-select front, panel 


The command above would be performed to build 
he front. panel and make the files ready to run. So, 
at last, we can run our robot nodes. There's just 
one more thing we need to know about (sorry), and 
hat is all to do with sourcing our commands. We 
alk to the operating system from within a ‘shell’ 
environment which accepts our commands and 
hen performs them. On Linux, this is usually the 
‘bash shell’. Some of the commands are ‘built-in’ to 
he shell; for other commands, the shell will go off 
and look for a program to run. We can tell the shell 
where to look for our robot node code: 


source install/setup.bash 


The source command means ‘find this file and 
execute it as if it has been typed in’. The command 
file is called setup.bash, and it is created for us by 
colcon when the package is built. Once we have 
performed this command, we can use the ros2 run 
command to start our two nodes running: 

Figure 6 shows two bash shells running the 
buttons and display nodes. The two nodes were 


started using the commands at the top of each 
shell. The buttons node has published four button 
messages and the display node has displayed them. 


ROS COMPLICATIONS 

At this point, you might be thinking one of two 
things: 'Blimey, this is complicated' or alternatively, 
‘Blimey, this is powerful’. The complexity is there 
for a reason. We want to be able to break our robot 
controller down into smaller reusable components 
which can be easily swapped without affecting the 
rest of the application. 

One robot might use a physical button to start it, 
but the next might have a touchscreen. Because 
this input is managed by a node, we just need 
to swap out the package node for another. Later, 
we might decide to combine the camera and the 
controller into a single device. In that situation, we 
just have to change the image. source node to run on 
the controller, and everything which uses images will 
just work. 

The package folder contains everything needed to 
build and run a particular set of robot nodes. There 
are many pre-built packages for robot interfaces 
and behaviours that you can slot into your robot and 
interact with via their services and topics. 


NODE MANAGEMENT 
One of the many wonderful things about ROS is the 
way that things ‘just work’. If you want two nodes 
to communicate, you just run them and they can 
magically see each other. 

ROS works over your local area network (LAN). 
Network communications are based on the DDS 
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Figure 6 $ 

These packages 

are running on a PC 
under the Windows 
Subsystem for Linux, 
but they could just as 
easily be running on a 
Raspberry Pi 


(Data Distribution Service) standard, which provides 
the discovery protocol by which nodes can identify 
themselves and find other nodes. ROS provides 
commands we can use to discover nodes, topics, 
and services. 

Figure 7 shows the output from three ROS 
commands which can be used to view an active 
ROS installation. The node list command lists all 
he active nodes - in this case, the button and the 
display. The topic list command shows all the 
active topics. The buttons topic is active, along with 
wo which are provided by ROS. The final command 
shows all the services that are provided. Note that 
he button and the display components expose a 
set of services which can be used to work with 
hem. This makes it possible for a ROS application to 
automatically discover what nodes can do and how 


o use them, which makes possible self-configuring 
systems. We can see this in action if we start up 
he rqt tool, which is supplied as part of ROS. This 
contains a range of plug-ins you can use to create 
interfaces with your ROS application. 

The гаї window in Figure 8 shows a view of the 
opics available on the left, a diagram showing the 
active robot topics in the middle, and a log of button 
opic messages on the right. We can see that the 
ast message that was sent was the 'start' message. 
These views are all updated in real time. 

Now we know how ROS applications are 
structured and how the components interact. In the 
next article, we'll build on this. O 


Figure 8 4 

You can add plug- 
ins and lay out the 
display as you like 


Figure 7 $ 
If other ROS nodes were active, they would appear 
in this output, too 
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Retro Gaming with Raspberry Pi shows you how to set up 
Raspberry Pi 5 to play a new generation of classic games. Build your 
gaming console and full-size arcade cabinet, install emulation software 
and download original games with our step-by-step guides. You'll 
discover a vibrant homebrew scene packed with new games for original 
consoles and legal access to all those retro games you remember! 


= Set up Raspberry Pi 
for retro gaming 


= Emulate classic 
computers and consoles 


= Learn to code 
retro-style games 


a Build a console, 
handheld, and full-size 
arcade machine 


BUY ONLINE: magpi.cc/store 


MS 1001 | FEATURE 


Raspberry Pi 5 
Cases 


Group Tes 


Phil King tests some of the best 
cases available for Raspberry Pi 5 


cooler inside a smart case. More importantly, a case can also help it to 

keep the board cool under a heavy workload, by using thermal pads, a 
heatsink, fan, or a combination of all three. To test the cooling effectiveness, 
we performed a stress test using all four of the CPU cores at the default 
maximum of 2400GHz. We also checked the Wi-Fi signal to see if the case 
interfered with it. In addition, we assessed each case's capacity - for mounting 
a HAT etc - and the access to Raspberry Pi 5’s ports. It's a best case scenario! 


R aspberry Pi 5 is one cool single-board computer, but it can look even 
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Official Raspberry Pi 5 Case 
Raspberry Pi | magpi.cc/case 
£10 / $10 


Coming in red/white or black, the official case comprises 
three plastic sections that snap-fit together, so assembly 
is a cinch. The middle section includes a clear insert with a 
fan that connects to Raspberry Pi 5's Fan port. A small SoC 
heatsink is also included. 


Capacity: By removing the clear insert and fan from the 
middle section, you can mount a HAT. Or you could use a 
booster header to lift it above the fan. 


Port access: АП side ports are accessible via cutaways, 
along with the power button. The middle section features 
a wide slot to enable access to the GPIO pins when the 
lid is removed; it could also be used for routing cables 
for a camera or other accessories. 


Cooling: The variable-speed fan's cooling is aided by vents 
in the bottom of the case, plus the SoC heatsink. It works 
even with the lid on, due to a circular gap. In our tests, 

it prevented throttling even under a heavy workload, but 
some other cases performed better. 


Wi-Fi signal: As you'd expect, the plastic case has very 
little effect on the signal, which remained strong. 


Verdict 
A well-thought-out, versatile design that covers most uses. 


€ 
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ICE Tower CPU Cooler 


The Pi Hut | magpi.cc/icetower 
£16 / $17 


Its cool-looking tower design is enhanced by RGB LEDs 
making it glow in various colours. Is it really a case? 
Well, it does have a plastic base, connected via screws 
and bolts to two metal mounting brackets and the main 
fan/heatsink section on top. Assembly is a little fiddly 
(especially the brackets), but not too tricky. The heatsink 
it connected to the SoC via a thermal pad. 


Capacity: You won't be mounting any HATs with that 
large fan and heatsink sitting atop Raspberry Pi! 


Port access: The open design means access to all the ports 
and GPIO pins is unhindered. 


Cooling: The vertically mounted fan blows air onto the 
aluminium fins of the large heatsink, whose base is 
connected to Raspberry Pi 5's SoC via a thermal pad. This 
results in excellent cooling performance. By default, the 
fan doesn't even kick in until the temperature reaches 
60°C (which didn't happen during our tests), but it could 
prove more useful if you're overclocking Raspberry Pi 5. 


Wi-Fi signal: The presence of that metal heatsink does 
have an effect on the signal, but not too much. 


Verdict 
With its unusual design and lighting, it looks very cool... 
and delivers great cooling. 
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Argon NEO 5 


Argon 40 | magpi.cc/argonneo5 
£18 / $19 


A three-piece design - with two aluminium sections 

and a plastic base - the NEO 5 oozes style and quality 
with its red/black colour scheme and solid feel. The 
middle section is especially impressive, with a fan next to 
curved fins to aid cooling. Assembly is aided by a guide in 
a small booklet. 


Capacity: With the top part removed, you could mount a 
HAT with a booster header to lift it over the fan. A special 
NVMe version of the case is also available. 


Port access: The middle section has cutouts for the main 
ports, camera/display, PCIe, UART, RTC, and the GPIO pins 
(with a helpful labelled strip on the side). 


Cooling: The fan's effect is aided by vents in the middle 
section and base, plus a couple of thermal pads for the SoC 


and PMIC. This results in very good cooling performance. 


Wi-Fi signal: The mainly metal case does result in a 
noticeable reduction in signal strength and quality. 


Verdict 
A stylish, quality case with great cooling performance. 
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KKSB HAT Case 
The Pi Hut | magpi.cc/kksbhat 
£16 / $16 


The tallest case in the group, it's 56mm high, and is 
designed to accommodate a Raspberry Pi 5 with a HAT 
mounted on top. The anodised aluminium case has no 
built-in cooling, but you could add an Active Cooler or 
heatsink. There's plenty of room, and a GPIO booster 
header is supplied if needed to lift a HAT up slightly. 
Assembly is tricky, as you need to remove both side 
panels and slide in Raspberry Pi, screw it in place with 
tiny screws, and then add a HAT afterwards. 


Capacity: The high headroom means there's plenty of 
room to mount HATs on top of Raspberry Pi. Getting 
things in and out of the case and securing them in place 
is fiddly, though. We'd have preferred a removable lid. 


Port access: The main ports are accessible via cutouts. 
There are slots for camera connections and PCIe ribbon 
cables. You'll need to remove one or both side panels to 
access the other ports. 


Cooling: There's no built-in cooling, but the KKSB can 
be used with an Active Cooler, or most other coolers and 
heatsinks. Lots of slots in the case aid ventilation. 


Wi-Fi signal: Maybe it's all those ventilation slots, but the 
signal is hardly affected. 


Verdict 
Not the most user-friendly design and no built-in cooling, 
but good capacity. 
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Passive Cooling Open CNC Case 
EDATEC | magpi.cc/opencnccase 
£7 [ $8 


Raspberry Pi 5 is sandwiched between the two case 
sections, with no side pieces. Each grooved aluminium 
piece is fitted with several thermal pads to aid passive 
cooling, including for Raspberry Pi 5's SoC, PMIC, and 
wireless module. The two case sections are secured 
with long bolts. 


Capacity: With the open design and GPIO header access, 
you can mount a HAT just above the top section. 


Port access: With no side pieces, access to ports is 
unfettered, with cutouts for the GPIO pins, PoE header, 


PCIe and camera/display ports, plus UART and RTC 
battery connectors. 


Cooling: Highly effective passive cooling is provided by 
the numerous thermal pads and grooved aluminium case 


pieces. It keeps Raspberry Pi 5 cool (37.8?C) even under a 
heavy workload. 


Wi-Fi signal: The metal case does result in a noticeable 
reduction in signal strength and quality. 


Verdict 


Great port access and some impressive passive 
cooling performance. 


ABS Fan Case 


The Pi Hut | magpi.cc/absfancase 
£15 / $16 


While it doesn't feel the most solid or weighty case, its two 
main sections have plentiful vents and you get a choice 
of coloured stripes to stick on the lid! An Armour Lite V5 


fan-equipped heatsink sits on top of Raspberry Pi 5 via 
five thermal pads. 


Capacity: The heatsink takes up a fair amount of space 
in the case. You could still mount a HAT with a GPIO 
header booster and the lid off. 


Port access: The main side ports are accessible via cutouts. 
With the lid removed, you can access all the others. 


Cooling: Five thermal pads connect the SoC, PMIC, RP1, 
RAM, and wireless module to the heatsink with built-in 


fan. Considering this, cooling performance was not quite 
as good as we expected, but decent. 


Wi-Fi signal: There's some effect on the strength and 
quality, possibly due to the metal heatsink. 


Verdict 
Middling cooling performance in a lightweight case. 
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Pibow Coupe 5 
Pimoroni | magpi.cc/pibowcoupe5 
£10 / $10 


Like previous editions of the classic Pibow, this case 
comprises multiple acrylic layers that need to be 
assembled to surround Raspberry Pi and then secured 
with four long bolts. It's like doing a 3D jigsaw puzzle. 
The top of Raspberry Pi is left open, which will suit 
some use cases better than others. 


Capacity: The case's open top design means you can 
mount any HAT you like. 


Port access: The USB and Ethernet ports sit on top of 
the case, while cutouts enable access to the rest. GPIO 
pins are fully accessible. 


Cooling: There's no built-in cooling, but the Pibow can 
be used with an Active Cooler or standard heatsink. 


Wi-Fi signal: As you'd expect from an open-top case, 
the signal strength and quality are very good. 


Verdict 
A multi-part, open-top case with no built-in cooling, 
but very versatile. 
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FLIRC Raspberry Pi 5 Case 
The Pi Hut | magpi.cc/flircrpi5 
£14 / $15 


Like previous models, this smart-looking FLIRC case is 
designed for use with a media centre setup. The main 
aluminium section also acts as a heatsink via a thermal 
pad stuck to Raspberry Pi’s SoC. There’s also a mini 
power button. 


Capacity: There’s no room for a HAT inside the case. 


Port access: The regular side ports are all accessible 
via cutouts, but the internal ones - including PCIe and 
GPIO pins - are not. 


Cooling: The metal case acts as one large heatsink via 
a thermal pad on the SoC, providing effective passive 
cooling. 


Wi-Fi signal: The metal case does reduce the signal 
strength and quality somewhat. 


Verdict 
A smart and robust case for a media centre. 
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Passive Cooling СМС Case 
EDATEC | magpi.cc/cnccase 
£15 / $19 


As with the Open CNC Case, the two case pieces are 
aluminium; here they lack grooves, but retain the thermal 
pads. The bottom part also has sides with cutouts for the 
ports. The result is a sleek-looking case with a snug fit. 


Capacity: The GPIO header cutout enables the mounting of 
a HAT above the top of the case. 


Port Access: Cutouts enable full access to the main side 
ports, along with GPIO pins, PoE header, PCIe and camera/ 
display ports, and UART and RTC battery connectors. 


Cooling: As with the Open version of the case, the 
numerous thermal pads (for SoC, PMIC, wireless, and 
underside) provide highly effective passive cooling. 


Wi-Fi Signal: Fully enclosing Raspberry Pi 5 in a metal 
box has an adverse effect on the wireless signal. 


Verdict 
A metal case with great cooling, but Wi-Fi signal isn't great. 
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Argon ONE v3 


Argon 40 | magpi.cc/argononev3 
£25 / $30 


The biggest case of the bunch, it features a daughterboard 
that plugs into the side of Raspberry Pi 5. As well as 
rerouting video and power to full-size HDMI and USB-C 
ports, its RP2040 chip handles cooling and power 
management. There's also an IR receiver to use with a 
remote (supplied separately). A removable magnetic flap 
in the case top reveals the GPIO pins and labelled strip. 
An NVMe version of the case is also available. 


Capacity: Despite the size, it's not possible to mount a 
standard HAT inside the case. 


Port Access: USB and Ethernet are accessible, along with 
power and two full-size HDMI ports. 


Cooling: An angled fan in the top case section is aided 
by two thermal pads. You need to install a script for fan 
control. Cooling performance wasn't the best, especially 
under stress. 


Wi-Fi Signal: Strength and quality were only slightly 
lower than with the official case. 


Verdict 
A feature-packed case that's ideal for a media centre or 
desktop system. M 
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Cooling comparison Wi-Fi signal 
We checked the typical CPU temperature when idling and under We tested the average strength and quality of Raspberry Pi 5's 
stress (with all four cores running at 2400MHz). Wi-Fi signal for each case. 
Idling Stressed Strength 
(°C) (°C) (dBm) 
Official Raspberry Pi 5 Case 7.2 DJ Official Raspberry Pi 5 Case -43 96 
ICE Tower CPU Cooler S172 48.8 ICE Tower CPU Cooler -59 7/6] 
Argon NEO 5 28.5 42.2 Argon NEO 5 559 73 
KKSB HAT Case* = = KKSB HAT Case -48 90 


EDATEC Passive Cooling Open EDATEC Passive Cooling Open 


CNC Case 57 375 CNC Case 8 ds 
ABS Fan Case 455 65.3 ABS Fan Case -57 76 
Pibow Coupe 5* = = Pibow Coupe 5 -46 93 
FLIRC 33.4 49.9 FLIRC -59 71 
аи passive on Eb 27.0 40.0 EDATEC Passive Cooling CNC Case ЕРЕ 64 
Argon ONE v3 39.5 67.5 Argon ONE v3 -50 86 


* No built-in cooling. 
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"|еатп coding = 
Discover how computers work» 
build amazing things! 


5" Edition 
Fully updated for 
Raspberry Pi 5 


The Official 
Raspberry Pi 
Beginner's Guide 


How to use your new computer 


Re 


Gareth Halfacree 


magpi.cc/beginnersguide 


ШЕШШ Magri | REVIEW 


Home Assistant Yellow 


> Home Assistant > magpi.cc/hayellow » £107 / $135 (without CM4) 


DIMENSIONS: 
123mm x 
123mm x 36mm 


POWER: 
12v/2A barrel DC 
jack, PoE* IEEE 
802.3at-2009 
Class 3 or 4 


EXTRA 
FEATURES: 
M.2 SSD slot, 
stereo audio 
DAC with 3.5mm 
jack output, 
enhanced 
wireless (Silicon 
Labs MGM210P 
Mighty Gecko 
Module), RTC 


Verdict 


Extremely easy to 
set up and use, it's 
a very compact and 
practical box that 
really helps power 
your home 


10 10 


Compute Module-powered home automation is only 
moments away with this powerful kit. By Rob Zwetsloot 


other forms of IoT is what a lot of people 

love to use it for, and thanks to that the 
hardware and add-ons that work with Raspberry 
Pi are easy to come by. Software-wise as well, one 
of the more popular systems is Home Assistant, 
which has been around for nearly as long as 
Raspberry Pi has itself. You can even find it in 
Raspberry Pi Imager. 

It's no surprise then that its branded hardware 

is pretty high quality. Powered by a Raspberry Pi 
Compute Module 4 (which you can supply yourself 
to keep the price down), and with PoE (power over 
Ethernet) capabilities, it’s a remarkably competent 
yet simple device on paper, picking up on any IoT- 
enabled hardware on your local network and very 
quickly letting you start controlling it. 


R aspberry Pi for home automation and 
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А Тһе case looks great and houses everything neatly inside 


Setting up the device is very simple, although 
depends slightly on the version you get. The 
kit that comes with a Compute Module 4 
already installed is basically ready to go, just 
requiring you to get it set up for your network 
and IoT add-ons. 

If you're adding the Compute Module, you 
just need to take the case off using the hand- 
tightened screws (no screwdrivers involved) and 
firmly click CM4 in. You can also add an M.2 SSD 
at this stage too if you want the extra storage. 
After that, it's just installing the OS via a USB 
stick (set up with Raspberry Pi Imager), and 
then doing the usual network setup. The longest 
part of setting up this way is just letting all the 
software install - in about 30 minutes we were all 
ready to go. 


Ш Home Assistant will let you 
know what devices it has 
found on your network El 


Automated automation 

During the last stages of set up, Home Assistant 
will let you know what devices it has found on your 
network. It has access to a huge range of services 
and standards as you'd expect, and puts any found 
devices on your dashboard for you to configure 
further. This is accessible via a smartphone app or 
your browser, and there's an astonishing level of 
customisability in the software. From the use of 
general active triggers for actions (including voice 
control) to different passive ‘scenes’ that will, 

for example, automatically lower the lights when 
watching TV. 

As this is positioned as a big hub on your 
network, you can also add plenty of other software 
services to it – such as Plex, Sonos, TOR, and a 
whole variety of extensions that you can easily add 
from the browser. The SSD slot will come in handy 
if you use the media server applications. 

It's a fantastic piece of kit that we found very 
easy to use without sacrificing any of the nitty- 
gritty home automation tools you'd want to use to 
truly customise your home - to the point that it's 
inspired us to expand the amount of automated 
devices in our home. El 
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The board comes 
with its own heatsink 
for CM4, as well as 

a PCle x1 expansion 
slot for SSDs 


У The dashboard 
surfaces a lot of 
information so that 
you can perfectly 
tweak your home 


disabled show = 


О ‘чт о 
MEN › 


O € o 


BM MJPEG IP Camera › 


Ф. openweatnermap 
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10 amazing: 
robot projects 


Automatons, rovers, and other robotic 
friends made with Raspberry Pi or Pico 


ne of our favourite things to make with Raspberry Pi 

is a cool robot. Whether you're making them fight at Pi 

Wars or racing them in Formula Pi, it's an incredible way 
to learn about coding and making. We've put together a list of 
very different robots to give you some inspiration El 


v BurgerBot 


Inedible round robot 
This Pico-powered robot is small and compact, and a great base for 
expanding and building bigger and more complex robots 


magpi.cc/burgerbot 
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> PicoTico 


Tic-tac-toe-bot 
Would you like to play a game of tic-tac-toe? This robot will play 
with you, but unlike WOPR (from 1983's WarGames) it's a bit more physical 


magpi.cc/picotico 


4 NE-5 


Who's Johnny? 

This compact robot inspired by Short 
Circuit's Johnny 5 is also powered by 
Raspberry Pi 5. It's a very advanced 
robot with stereoscopic vision 


magpi.cc/ne5 


v C-Turtle 


Landmine clearing robot 

This clever and very cheap robot is great for clearing minefields, which 
hopefully is not something you'll have much need for. If you do, though, 
know it's made of cardboard and does move like a turtle. 


magpi.cc/cturtle 


MägPi 


The theory behind Rubiks cube solving is fascinating, and so is the sport of 
doing it with speed. While this robot won't be beating any world records, it's 
very fun to watch. 


This helpful robot keeps an eye on your 3D printer and looks very cute 
while doing it. It's also 3D printed itself! 


This fortune teller uses 
ChatGPT to predict your 
fate. It's probably not 


——— This robot uses facial recognition to greet going to be correct, but 
people at the door, and was created during it's also about as accurate 
COVID lockdowns. It alerts the home owner as star sign horoscopes, 
when someone arrives, and even talks to them so your mileage may vary 
Weeding can be a long task that requires a sharp eye and precision, a This full-size replica of the classic Doctor Who prop recreates the 
perfect use case for machine learning on a robot in a big field, which original and adds several features the older version didn't have, such 
uses computer vision to detect and then pick weeds as touch sensors 
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Learn Visual Studio Code 
with Raspberry P1 


Get to grips with Microsoft's popular code 
editor with these resources. By Phil King 


Introductory videos 


with a host of programming 
languages, including C/C++, 
Cit, Python, Java, JavaScript, 
Markdown, and Node.js. 

Best of all, Visual Studio Code 
is available for Raspberry Pi and 
can be easily installed using the 
Recommended Software tool 


Microsoft Microsoft's Visual Studio Code (found in Menu » Preferences). 

m is a lightweight but powerful You can then launch it from the 

din | cross- platform code editor Programming submenu. _—.- eere 

Te that offers great debugging The best place to start E = Gees 
I tools and a huge system of learning about Visual Studio Ld — ae 
extensions. It can be used Code is via Microsoft’s own > = 
series of introductory video Ed == “ 
Co — — — — 


y 


tutorials. The first one walks 
you through setting up Visual i 
Studio Code and gives an 
overview of its basic features 
- all in just seven minutes. 
You can then move on to Code 
Editing, Productivity Tips, 


| 


Personalize (using themes), 
Extensions, Debugging, Version 
Control, and Customize (settings 
and keyboard shortcuts). El 


Online courses 


Enrol in a Visual Studio Code web course today 


VSCODE POWER USER 

This paid-for course comprises 
65 videos in which the engaging 
Ahmad Awais delves deep into VS 


> vscode.pro 


MASTERING VISUAL 
STUDIO CODE 

One of several Udemy courses 
on VS Code, it aims to boost 


Code and offers time-saving tricks. 


your productivity. Modules cover 
several coding languages and many 
useful topics. 

> magpi.cc/vscudemy 


VISUAL STUDIO CODE 
Pluralsight's course by John Papa is 
highly rated and covers the basics 
along with advanced user tricks like 
multi-cursor and task automation. 
> magpi.cc/vscpapa 


VSCode Power User 
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RESOURCES | Magri ВЕ 


Visual Studio Code 
Can Do That? 


Front End By opening a free Front End top to bottom. Along with the 
Masters Masters account, you can gain fundamentals, it shows you how 
i access to five video courses, such to turn Visual Studio Code into a 
Price: В " А ; 
Егее as this опе on Visual Studio Code ^ full IDE (integrated development 
. presented by Burke Holland. environment) to refactor and 
magpi.cc/ | n : ; 
vscodecando Aimed at increasing your speed debug code, work with databases, Useful 
and productivity, it promises to and more. И 
examine the code editor from Following an introduction and web sites 


ee tour of the editor, course sections 


(each comprising multiple videos) 
include customising the editor, Some sites to visit 
productivity tricks, navigation and for helpful info 
refactoring, debugging, Docker, 
remote development, working 
with data, and Git. In all, the 
course comprises over 3.5 hours of 
video. Resources and downloads 
can be found in the GitHub repo 
and GitBook. Hl 
KEY BINDINGS 
This useful documentation 
: : page shows you the default 
Extension Marketplace Guide =ч 
Studio Code, and also how to 
change them. 
Microsoft One of the best features of extensions available, offering > magpi.cc/vsckeys 
7. — Міѕиа! Studio Code is that a huge array of potential extra 
ioni i you can customise just features for the code editor. 
: about everything in it by These range from testing and MARKETPLACE 
magpi.cc/ А А з - 
тесштен adding extensions. security tools to productivity Browse the thousands of 
You'll certainly be spoilt for boosters (such as code analysers extensions available for Visual 
choice as there are over 30,000 and cleaners) and collaboration Studio Code, the vast majority 
extensions such as LiveShare. of them free, with helpful filter 
Doom o ooo You can even create your own | ana sort options. 
— c — extensions if you know how. > magpi.cc/vscmarket 
The official Extension 
Marketplace documentation 
shows how to find, install, and AWESOME VSCODE 
manage VS Code extensions Want even more resources? 
from the Visual Studio Code Viatsko's GitHub repo has a 
Marketplace. In the editor, curated (and long) list of useful 
selecting View » Extensions links, helpfully arranged into 
shows you the most popular ones, categories. 
each with a brief description and > magpi.cc/ 
user rating. Try a few out to see if awesomevscode 
they can help you. El 
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WE Mägi | INTERVIEW 


P» The project that spurred 
rpilocator is an Ethernet 
board for Compute Module 4 


84 | magpicc | André Costa 


Had trouble finding a Raspberry Pi during the supply 
chain problems? Andre and his rpilocator had your back 


> Name AndréCosta | 
> Community role 


or a while it was a bit 
" difficult to get a new 
Raspberry Pi. With 
the global supply chain still 
recovering from COVID, people 
who wanted a Raspberry 
Pi had to wait patiently for 
Approved Resellers to get new 
stock - or pay exorbitant prices 
second hand. This is where 
André Costa came to the rescue 
with rpilocator. 

“Sometime around November 
of 2021, I started on a project 
making a carrier board for the 
СМА and I needed some units 
to test my prototypes," Andre 
tells us. "That's when I noticed 
the availability of Raspberry 
Pi computers in general was 
low. Initially, I registered for 
stock notifications at a couple 
of authorised resellers. I got a 
couple of email notifications a 
few days in a row, but they were 
always sold out before I could go 
to the seller's website." 

The service we now know 
as rpilocator started off as 
cm4locator, with André coding 
it during a couple of days off. 
Initially it was private, and 
within a couple of days it had 


Stocktracker | 


» Occupation Tech support 


» URL rpilocator.com 


helped him locate - and buy - a 
Raspberry Pi Zero 2 W. Surprised 
at how easy it was, he decided to 
make a public version. 

“I registered the domain on 
January 26 and spent a couple 
of hours a day after work adding 
more listings to be tracked," 
André says. “On January 29 I 
pushed the website to a cloud 
service. Rpilocator was officially 
live but no one knew about it. 
I waited a day to make sure 


ney Pi Compute Module 4 , 


Wade -je he Uk 


everything was working and 

I sent an email to Lee from 

leepspvideo and Jeff Geerling." 
From there, word spread, and 

rpilocator became the best way 

to find a Raspberry Pi. 


What is your history 

with making? 

I grew up in a household where 
both my parents were very handy 
at making things. My dad is an 
engineer who loves tinkering 


ҮР ТРА 


NI < 


dphacks.com 
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У This Raspberry Pi Pico-powered air 
quality sensor helped André and his 
family when Canada wildfires caused 
issues as far away as Brazil 


2 My pie-in-the-sky project would be 
something that combines scientific 
knowledge and artistic expression EJ 


with everything. I remember 
one of the first projects we 
worked on together was a crystal 
radio receiver - the classic kid 
introduction to making project. 

I grew up in Brazil and access 
to maker kits wasn't as widely 
available as in the US or the UK. 
This was in the ’80s and the 
’90s. There were some STEM 
magazines available in English 
and that was one of the reasons 
why I wanted to learn English. 

My mom started sewing when 
she was young and she's an 
experienced seamstress. Seeing a 
flat sheet of fabric turn into a 3D 
object was so inspiring to me. I've 
played with and created things 
with textiles my whole life. 


What projects have you made 
with Raspberry Pi? 
I've used Raspberry Pi in quite 
a few projects over the years 
ranging from a network of 
sensors to home automation and 
camera applications. 

Last year, there were many 
large wildfires in Canada. A lot 


of the smoke drifted into where 
we live. The air quality outside 
was unhealthy for long periods 
of time. My daughter hadn't 
turned one yet and I wanted to 
make sure the air quality inside 
our home was healthy for her. I 
created a PCB that hosts a Pico 
W and makes it easy to plug 

an air quality sensor and I2C 
devices to the Pico W. It runs 
an open-source CircuitPython 
firmware that calculates the Air 
Quality Index inside our home 


and sends sensor information 
through MQTT. 


What is your dream project? 
I find the intersection between 
science and art so intriguing. 
My pie-in-the-sky project 
would be something that 
combines scientific knowledge 
and artistic expression. I don’t 
know exactly what it would be. 
Maybe something that would 
spark kids’ interest in learning 
more about science and art. El 
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A ARaspberry Pi Camera 


Module zooms in on 
André's soldering efforts 


4 There's a lot of green on 


rpilocator now that supply 
chain issues are mostly 
resolved around the world 
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ШШЕН Mägi | THIS MONTH IN RASPBERRY PI 


Events 1n pictures: 
Program Komuniti 
Budak Coding 


Community and official events in the wild 


off with learning about the terminal on 

Raspberry Pi OS, with Python planned for 
the next session. Apparently the kids stormed 
through with the terminal and were able to start 
learning about simple Python games. 


T his Malaysian coding event for kids kicked 


01. The classroom was smalL but the brains on the 
kids participating definitely were not 


02. Making use of Raspberry Pi Foundation projects 
to learn Python with game programming 


03. A bingo game was done to break the ice early 
in the sessions 


04. "We hope. with this small effort, we are able to 
produce Malaysians who invent new technologies." 
say the organisers 
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THIS MONTH IN RASPBERRY РІ | Мас EN 


Pico 
Throttle 


With recycled cardboard and a potentiometer, 
you can get analogue flight control A After eating some chocolate, you just want to 


fly around the sky in some virtual planes 


N 


throttle lever that he’d made out of Easter 

egg boxes (and a lot of hot glue). It’s an 
ingeniously simple construction - a Raspberry Pi 
Pico measures a potentiometer, which is attached 
to a cardboard handle on a little rod so it can turn. 
Using HID code with CircuitPython, he can then 
send an analogue signal to his PC as a control axis 
= perfect for flight sims or Elite Dangerous. It also 
features a digital button on the back of the throttle 
to set maximum reverse thrust for when you move 
the lever beyond the idle position. 

“Гуе often had the occasional flight on my 
grandad's copy of Flight 
Simulator X when I visit him, 
but I purchased X-Plane 12 
after Christmas, so I've been 
using it regularly for about 
three months." Leo tells us 
about what inspired him. "(The 
throttle is] reasonably rigid. 
There's some flex in the lever 
side-to-side, so the plate that 
pushes the reverser button has 
to be a bit wider, but the box 
and paper-tube pivot is solid 
enough. It is, however, very 
light and likes to move around 
the desk." 


| eo emailed us early in April to show off his 


A It's held together tape, hot glue, and we 
assume a few prayers to the Easter bunny 


P» The full setup includes a Raspberry 
Pi displaying data exchange plugin 
SimVim for more interactivity 
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M P | 
Extreme Electronics 
@themagpi Finishing off my pair of Farnsworth's ( from 
Warehouse 13 fame.) 


They can talk to each other with both audio and video, either both 
on the same network or externally via a python "Strowger" server (I 


Amazing projects direct from social media! decided against calling this Exchange) over UDP 


Each contain a PI #PicoW a Circular display, microphone, speaker 
and a camera 


very Monday we ask the question: have you 
made something with a Raspberry Pi over 
the weekend? Every Monday, our followers @Raspberry_Pi 
send us amazing photos and videos of the things З 
they've made. 
Here's a selection of some of the awesome things 
we got sent this month. Remember to follow along 
at the hashtag ttMagPiMonday! 


Details on the build 


01. People often use 3D printed items to modify their 
3D printers, but we like to see some LEGO in use 


02. This is based on a fictional 1929 wireless 
communicator, and looks very cool 


03. Music updates are still continuing! 


04. This is great, we love how cheap and simple it Е 
must have been to build e dendi 


05. We love a good portable Raspberry Pi - we should 
do another feature for Raspberry Pi 5 


@themagpi 


06. We wish Boop good luck with its new brain My revised filament guide with Lego pulley wheel seems to be 
working well, but I'm keeping an eye on it just in case - assisted by 
a #raspberrypi Zero camera, using MotionEye OS, so | can check 
remotely using my phone, rather than dashing up and down stairs 
all day. 


па 5 а 
È os 
| | 


motionEye 
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MägPi 


#MagpiMonday continued work on Boop's brain transplant, 
replacing a pizero + servo board with a @pimoroni Inventor2040W 
for a neater fit. 

Next task add a web interface for manual control. 


diyelectromusic 
' y. : diyelectrot ic(ü mast \ 


@themagpi I've updated my Raspberry Pi based Zynthian synth 
with a new front panel. 


BH BH BH BH 
a ctt 


"d STEAM Annie ## 
Аппіес Ш 


Flappy game іп #руїһоп using my new Raspberry Pi portable set-up 4 BH BB BB BB ` 
which І bought from #RaspberryPi store #1 eeds @themagpi 3 4 - 1 ғ 
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Daniel Hernandez 
Finished project, 3D printed car and controlled by 
bluetooth with Raspberry Pi Pico W. 


07 dec AUI 


Argon 
NECO 5 NVMe 


Raspberry Pi 


EATIVITY 
A PHOCESS 


Argon 
THRML 60-RC 
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Your Ё 
Letters 


Weather forecasting 


I am attempting to complete the ‘Build a weather station’ 
project by Phil King described on page 132 of the 2024 Official 
Raspberry Pi Handbook. I am having a problem which is 
described below. 

I am using a Raspberry Pi 4 with Bullseye. Per the 
instructions, I have set up Raspberry Pi, mounted the HAT, 
installed the software and rebooted Raspberry Pi. However, 
when I perform step four, ‘Initial testing’, I get the following 
error message: 

$ cd weatherhat-python/examples 
$ python weather.py 


Traceback (most recent call last): 


File */home/mbliz/weatherhat-python/examples/weather. 
py", line 738, in «module» 


main() 


File */home/mbliz/weatherhat-python/examples/weather. 
py", line 698, in main 


display = ST7789.ST7789( 


File */home/mbliz/.local/lib/python3.9/site-packages/ 
ST7789/ init .py", line 123, in init _ 


self. spi - spidev.SpiDev(port, cs) 
FileNotFoundError: [Errno 2] No such file or directory 
I am a Raspberry Pi neophyte, so I am unclear what the error 


message is referring to, much less how to troubleshoot it. I 
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would be very grateful if you could give me some guidance on 
how to proceed. 


Mike via email 


With the ever- changing nature of technology, we discovered 
while helping Mike that to get this project working that you'll 
now need to install the program slightly differently. The original 
version of this tutorial has you build the software, however it's 
now available in the Python PIP repository. 

If you ever get stuck in a coding project like this, we 
always suggest checking the original website (in this case 
magpi.cc/weatherhatgit), and you can also drop us an email at 
magpi@raspberrypi.com. We will do our best to point you in 
the right direction. 


A The Weather HAT project is well worth your time - it's 
useful and a great way to learn about meteorology 


Hi, does the “Save 35% off the cover price with 
a subscription to The MagPi magazine" for UK 
subscribers apply to me if I live in the USA if I 
want to get a 12- month subscription? 


Austin via email 


Our subscription offers are slightly different 
depending on where you live - the discount is 
based on how much you'd spend buying each issue 
individually versus the cost of the subscription 

as a whole, so the rate on the US subscriptions is 
slightly different. You can find out about all our 
subscription offers here: magpi.cc/subscribe 
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ШЕШШ Mägi | EVENTS 


Community 
Events Calendar 


Find out what community-organised Raspberry Pi-themed 


events are happening near you... 


01. Pi Force 

^ Friday 3 May 

9 Lincoln Corners Pakistan, Karachi, Pakistan 

> magpi.cc/piforce141 

Come join us for a day of tinkering, hacking and learning 

- we will be having multiple sessions from basic 
electronics and soldering, to Arduino, then moving to 
Raspberry Pi as a desktop PC, hacking PC, and robotics PC. 


| 03 MAY 2024, FRIDAY 


(1102077776787 @ eescepicteumng 


02. Mayday Pi Jam Leicester 

© Monday 6 May 

$ Leicester Hackspace Unit 40, Leicester, UK 

> magpi.cc/mayday141 

Leicester Hackspace is holding another Pi Jam on 
Bank Holiday Monday, May 6, between noon and 4pm. 
The focus will be on using the camera for posture 
detection, astronomy and as a nature cam. Along 

with robots, of course, Raspberry Pi Pico and other 
Raspberry Pi projects. 
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03. Riverside Raspberry Pi Meetup 
^ Monday 13 May 

9 3600 Lime Street, Riverside, CA, USA 

> magpi.cc/rrpm141 

The purpose of Riverside Raspberry is to share knowledge 
related to Raspberry Pi hardware in particular, and to 
promote interest in tech development in California's Inland 
Empire in general. The group is currently meeting on the 
second Monday evening of every month. 


Ld 


Riverside Raspberry 


Raspberry Pi Users Group 


vx 
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www.meetup.com/Riverside-Raspberry 


FULL CALENDAR 


Get a full list of upcoming 


community events here: 

04. Kisii Raspberry Pi Jam magpi.cc/events 
© Saturday 18 May 
Q9 Kereri Girls School, Kisii, Kenya 
> magpi.cc/kisii141 
Kisii Raspberry Pi Jam: igniting young minds through 
tech exploration! 

Calling all tech enthusiasts in Kisii! Join us for an exciting 


Raspberry Pi Jam at Kereri Girls School, a premier public 
girls’ school known for its academic excellence. This 
event is designed to introduce students to the wonders of 
technology through hands-on workshops and exploration 
with Raspberry Pi kits. 
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B GITEX AFRICA 2024 


MEET RASPBERRY Р! 


Gitex Africa 2024 


> Where Place Bab Jdid, Marrakesh, Morocco 
> When Wednesday 29 May to Friday 31 May 


The Raspberry Pi team is delighted to be visiting 
Marrakesh, Morocco for our first visit to Africa’s 
biggest tech and startup show: Gitex Africa 2024. 
There you'll be able to meet our team and experience 
the full range of our technology, including Raspberry 
Pi Pico, RP2040-based solutions, Compute Modules 
and Raspberry Pi single-board computers as well as 
cameras and our range of high-quality accessories. 


magpi.cc/gitex24 
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ИШЕН Mägi | COMPETITION 


АЙМ ЕАМ 


ED-HMI3020 
TOUCHSCREEN 


This rugged display can safely and securely house a Raspberry Pi 5, 
and features a ten-inch touchscreen with a resolution of 1200x800. 
The screen is designed for industrial settings, but also works great 
as a portable kiosk in your home or office. 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/edhmi3020 


Terms & Conditions 


Competition opens on 24 April and closes on 30 May 2024. Prize is offered to participants worldwide aged 13 or over, except employees of Raspberry Pi Ltd, the prize supplier, their 
families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any publicity generated 
from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants' details will remain strictly 
confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange delivery. Any 
winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, or associated 
with, Instagram, Facebook, Twitter or any other companies used to promote the service. 
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What to do when you suddenly have 
a desk in the office, wonders Rob Zwetsloot 


before, or it may be just 
common knowledge because I 

tend to reveal too much personal 
information, but the editorial 
team on The MagPi and HackSpace 
magazines generally work from 
home. We all visit the main office 
once a month, but editor Lucy heads 
in every week because she's just that 
dedicated (and lives a lot closer than 
the rest of us [it's the free coffee 
machine - Ed!]). Anyway, Raspberry 
Pi recently moved to a new office, 
and for the first time since joining 
Raspberry Pi, I now have a desk! 

This has caused me a little bit of 
a quandary though. My desk in the 
office is my home away from home 
and I want to make it feel comfy and 
welcoming when I visit. However, 
I'm not there that often, so I can't 
bring in stuff I need at home, where I 
do most of my work. 


| 've probably mentioned here 


Sparse 

Currently I've brought in an original 
Raspberry Pi Zero from the cover of 
an issue 40, still in its blister pack, 
a 3D POP camera, some jingle bells I 
found, and a little ceramic hedgehog 
with a fake succulent plant growing 
out of it. It's also got some prizes 
there for future competitions but 
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they'll come and go so that’s a bit 
different. The benefit of bringing 
stuff in also means I won't have it 
filling up my home any more, but 
don't tell the boss that. 

Гуе been thinking about having 
little Raspberry Pi and/or Pico- 
powered devices to keep there 
- I have threatened to make a mini 
set of two drums and a cymbal so 


indulge in hobbies at while being 
comfortable. I have the luxury 
of being able to personalise my 
working space at home as well as my 
hobby space, which is full of boom 
arms holding cameras, lights and 
microphones though. I may have 
chosen the wrong hobby. 

It's taken me a while to get to 
this stage, so don't get frustrated 


m | have threatened to make a mini set 
of two drums and a cymbal so | can 
make a rimshot machine to punctuate 
my steady stream of bad jokes Ø 


I can make a rimshot machine to 
punctuate my steady stream of bad 
jokes - and as we have a fancy new 
maker lab here with lots of toys 

- er, I mean serious tools - I feel 

I should make use of that while 
I'm visiting. Send me suggestions 
for simple little machines to the 
usual places! 


Something to call your own 
This is clearly a fairly unique and 
low-level problem, but I wanted to 
bring it up because it is important 
to be able to have a space to work/ 


if it takes a while for you to get a 
space you can feel comfy in. Just 
like learning any skill, it can take 
practice as well as some trial and 
error. Also, money. 
I now need to figure out the work 

policy on how many hedgehog 
plushes I can keep on my desk. El 


Rob Zwetsloot 


Rob last had a desk in an office nine years 
ago, where he kept old Power Ranger toys 
and a foam sword from a tech conference 
he attended at Walt Disney World 
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GHPI PRO 


.———————— The new case from the HiPi.io team —————* 


geting, д 


€ Rapid tool-free assembly and disassembly € Secure microSD card cover 

€ Large internal volume for HATs € VESA mount support 

e Compatible with Pi 2/3/4 e Molding-configurable output ports 
e Multiple lid options customizable for volume orders 

€ Passive & Active Cooling options e Printed logo for your branding 


Available at these great Pi stores: 


x d Ly d “2 ба 
&-PiShop.us { РіЅ$һор.са 4° Рї$һортх — GJsPiHut PiSHor.ch Welectron. 


Contact your favorite Pi store if it's not listed here 


@ Мападе уоиг 
servers or PCs 
remotely! 


Ветоїе сопїго! redefined 


PiKVM V4 Mini 
Small, cost-effective, and powerful! 


e Power consumption in idle mode: just 2.67 Watts! 
e Transfer your mouse and keyboard actions 

e Access to all configuration settings like UEFI/BIOS 
e Capture video signal up to 1920x1200@60 Hz 

e Take full control of a remote PC’s power 


PiKVM V4 Plus 


The most feature-rich edition 


e M SABO 
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e More connectivity 

e Extra storage via internal USB 3.0 
e Upgraded powering options 

e More physical security features 

e Extra HDMI output 

e Advanced cooling solution 


A cost-effective solution for data-centers, 
IT departments or remote machines! 


Available at the main Raspberry Pi resellers 


e cere WoRPishop. Welectron. lektor e 
Pi-$uoe.cu G9: piHut & Pi .us 6°@ CloudFree = KUBII Cytron У 
ROBYN — RETTOF (SRaspberryPi.ck 


HIP1.10 


No reseller in your country? List of official 


Check shop.hipi.io (import fees might apply). resellers by country: OR 


